Skip to main content

Notion Integration

Efficient website feedback with Notion in a few simple steps.

Get detailed website feedback reports directly into Notion. When your team and clients find issues, they can annotate them directly on your website. No need for clients to install anything. Your team gets a detailed report straight into Notion.


Set up a Notion integration

Before you start: make sure you have at least one Table or Database set up in Notion where you want to collect website feedback.

Add a project

On the Marker.io dashboard, create a project, entering the project name and the website where you wish to collect feedback.

Select the Notion integration, then allow Marker.io to access your Notion database.

Configure forms

Marker.io fetches your native Notion fields into your widget form. You can show/hide fields and preset values. For example, set the default Priority to Medium and let reporters change it as needed.

Note: Marker.io members report through the Member form, while Guests and Public Reporters report via the Guest form. More on that in our User Roles: Admins, Managers, Members, Guests & Reporters guide.

Manage project access

Separately from your Notion connection, Marker.io controls who can see and manage feedback for this project via Manage access (top-right of the project's Widget or Feedback view).

Two ways to grant access:

  • Groups > Workspace members: toggle this on to give everyone in your Marker.io workspace access at once

  • People: invite individuals one at a time. Each can be removed independently. Guest-level users show a GUEST badge next to their name, distinguishing them from full members in the list.

Admins always have access regardless of this setting. This is separate from your Notion project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying Notion project, or the other way around.

Install widget

Go to your project's Widget > Installation and choose how to install.

Tip: click Try on demo website first to test-drive the widget before installing anything on your real site.

  • Browser extension: quick setup, no code required. Each reporter installs the extension individually. You can also toggle "Inject widget on my website" per domain to show it automatically for extension users on that site.

  • Code snippet & CMS plugins: a one-time, site-wide install, accessible to all reporters. Sub-tabs cover Code snippet (paste into the <HEAD> tag), NPM package, CMS plugins, and Send to developer (one-click handoff).

  • AI coding agent: point your AI coding agent at this and it picks the right install method (npm, snippet, or CMS plugin) and wires it up for you.

Once installed, anyone who can view your website, whether staging or live, will see the Marker.io feedback widget. If you used the browser extension method, remember: each reporter needs the extension installed in their own browser before they can see the widget.


How it works

Collect feedback

Reporters can submit feedback directly to your Notion project without leaving their website. Their feedback automatically includes detail-rich technical data.

Say the Contact Us button is broken on the About Us page. The reporter clicks the widget and is presented with a screenshot and a feedback form to complete. The screenshot can be annotated, and the form can be as simple or as complex as you wish. We recommend keeping it simple for non-technical reporters.

Review issues

You can review feedback both in Marker.io and in your Notion project. In Notion, feedback arrives with a clear screenshot and automatically captured technical data:

  • Page URL

  • Browser

  • Screen size

  • Operating system

We also provide links to console logs, network requests, and a session replay video of what the reporter did just before submitting, so your dev team has the complete context.

Communicate with reporters

The "Contact via Marker.io" link opens the Feedback Page, where you can reply to the reporter. They'll receive an email where they can reply too. Marker.io syncs these replies to Notion as comments on the original block, keeping pages clean and organized (see the resync note below if you're not seeing this behavior yet). Comments made directly in Notion don't sync back to Marker.io the same way. Reply from the Feedback Page if you need the reporter to see it.

Synchronize status

When you mark an issue "Completed" in Notion, Marker.io automatically updates the status to Resolved in Marker.io and emails the reporter to let them know. No need to update things in two places.

To manage your status sync settings:

  1. Open your project in Marker.io and go to Settings.

  2. Select Integration.

  3. Under Status Sync, choose your Notion status field to keep in sync with Marker.io.

  4. Toggle status sync on or off whenever you want.

  5. Decide whether Marker.io should add a comment in Notion when the status changes.

Want to learn more about how Notion handles statuses? Check out Notion's Status Property guide.


Permissions & troubleshooting

Is Marker.io secure?

We take your data and the security of our systems seriously, using industry-standard security practices to connect with your account. See our latest security policy at marker.io/security.

What permissions are required to integrate with Notion?

Admin permissions are required on the Notion project you wish to connect with. If the connected account is later removed, or its role is downgraded, sync will silently stop working. This is the most common cause of "issues stopped syncing" reports.

We recommend creating a dedicated Marker.io Bot user in Notion rather than connecting a personal account, so sync doesn't break when an individual leaves the team or changes roles. See [[Create a Service Account or Dedicated User for your integration]].

Issues not syncing to Notion

If issues have stopped appearing in your Notion database:

  1. Check that the Notion account connected to Marker.io still has access to the target database.

  2. Confirm the database is still shared with the Marker.io connection (see "I don't see my database" below).

  3. Go to your Marker.io project's Settings > Integration and click Resync account.

  4. Submit a test issue and confirm it appears in Notion.

I can't connect my Notion account to Marker.io

Try the following, in order:

  1. Log in to Notion in a second tab. This ensures your username and password don't trigger extra security verification. Once logged in, return to Marker.io and try connecting again.

  2. Reset your Notion password, then attempt to reconnect.

  3. Still stuck? Start a chat with us using the icon in the lower right corner.

How do I add custom fields in Marker.io via the Notion integration?

  1. Add custom fields in Notion. See Notion's Custom Fields guide for details.

  2. In Marker.io, go to the relevant project > Widget > Guest forms (or Member forms) > drag the custom field into the "Drop fields here to make them visible" zone.

I don't see my database

If you don't see your Notion database in Marker.io after connecting the integration (see "Create a Marker.io project" above), add the Marker.io connection directly in Notion:

  1. In Notion, open your database, click the three dots (top right) > Connections > Add connections > select Marker.io.

  1. Back in Marker.io, refresh. Your database should now be available.

I don't see the Notion relation field on my forms

Notion's one-way relations are backlinks to a linked page. They don't count as a true "relation" since the linked page isn't related back to the original. Because of this, the sync needs to be a two-way relation for it to appear as a field in Marker.io. You'll also need to make sure both databases are shared with Marker.io, as covered in "I don't see my database" above.

For example, if Database 01 has a Relation field pointing to Database 02:

Click Edit property and make sure Show on Database 02 is toggled on:

For more detail, see Notion's two-way relations guide.

How do I add feedback in Notion as a sub-item of previous feedback?

You can organize feedback as subtasks under a primary task using Notion's parent/sub-item functionality.

Enabling subtasks in Notion:

  1. In the top right corner of your Notion table, click the three dots to open settings.

  2. Find the option to enable sub-items and turn it on.

Enabling this introduces Sub-item and Parent Item fields on your Marker.io forms. Decide whether these should be pre-selected and hidden from reporters, or editable. Letting reporters choose the parent item can encourage more detailed feedback but needs more moderation.

Resync your Notion account to enable comment updates

If you've used Marker.io with Notion for a while, you'll notice feedback updates (like comments) appearing as new content blocks at the end of your Notion page rather than as comments. To fix this, resync your account:

  1. Go to Projects and select your Notion project.

  2. Go to Settings > Integration.

  3. Scroll to Main account.

  4. Click Resync Notion account.

Using more than one Notion account

If you manage multiple Notion accounts, see [[Managing Multiple Integrated Accounts]] for how to set this up cleanly without accounts overwriting each other.


Invite your team to collaborate on a dedicated Notion project today with Marker.io, where anyone can report bugs and feedback in seconds. See [[Get started with Marker.io]] for more on getting the most out of your setup.

Need Help?

If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.

Did this answer your question?