Collect website feedback as new issues directly in your Notion projects. With our 2-way synchronization, your fields and comments are always in sync.

Set up a Notion Integration

How it works

FAQ


Set up a Notion Integration

Connect your Notion account

To get started, go to the Marker.io dashboard and add a destination. A destination helps link your website to your Notion project.

Ensure that you have at least one Table/Database set up on your notion account where you want to collect website feedback. Connect your Notion account.

Once you connect to your notion account, you get to select any pages you'd like Marker.io to access. Ensure that you chose at least one Table/Database.

Add a destination

Select the Notion Database where you wish to collect website feedback and provide the website domain (optional) where you would like to install the Marker.io widget.

Configure forms

We fetch your native Notion fields into your widget form. You can show/hide any fields and preset fields with dynamic values. For example, set the default Priority as Medium and allow reporters to change that field 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 Guide.

Install widget

The last step is to install the website widget. We have many options for installing our widget and recommend our manual JavaScript install in most cases.

Alternatively, install the widget via WordPress plugin, NPM package, or send a request to your developer in one click.

Visit your website, refresh and check that the widget appears.


How it works

Collect feedback

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

Let’s say the Contact Us button is broken on the About Us page. The reporter clicks on the widget and is presented with a screenshot and a feedback form to complete.

The screenshot can be annotated, and the feedback form can be as simple or as complex as you wish. We recommend keeping the feedback form as simple as possible for your non-technical reporters.

Review issues

In your Notion project, you see the feedback arrive with the screenshot and automatically captured technical data, including:

  • Page URL

  • Browser

  • Screen size

  • Operating system

Communicate with reporters

The "Contact via Marker.io" link opens the Feedback Page, where you can communicate with your reporters. All conversations will be synced with Notion.

Synchronize Status

At the moment, the Notion API is still in BETA. This means it is difficult for us to implement Status Sync on the Notion integration. If you would like our team to build this out, please consider voting on that feature request here:

https://marker-io.canny.io/feature-request/p/notion-two-way-sync

Also, add some commentary on how it would benefit you. Every additional vote and comment will help convince our team to build out this feature.


FAQs

Is Marker.io secure?

We take your data and the security of our systems very seriously, using the most advanced security to connect with your account. See the latest version of our security policy at: https://marker.io/security.

What permissions are required to integrate with Notion?

Admin permissions are required on the Notion project you wish to connect with.

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

Any issues setting this up? Try the following:

  1. Log in to your Notion account

    Log in to Notion in a second tab. This ensures that your password and username do not require additional security verification. When logged in to Notion, return to Marker.io and try connecting your Notion account.

  2. Reset your password in Notion

    Try setting a new password in your Notion account and see if that helps to resolve the issue.

  3. Still not working?

    Please start a chat conversation with us in the lower right corner of your screen.

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

Custom fields are a powerful customization tool allowing you to add new field types and custom data specific to your workflow.

  1. Add custom fields in Notion.

    See the Notion Custom Fields guide for more details.

  2. Enable your custom fields from Notion on your Marker.io forms

    • Select the relevant Notion destination

    • Widget Settings

    • Guest form (Or Member Form)

    • Unhide the custom Field by clicking on the eye icon beside the Field.

    • Save your form.


I don't see my Database.

If you don't see your Notion database on Marker.io after following the above steps, you may need to add the Marker.io connection in Notion directly to your database/table.

Below we have Database 01 and Database 02 in Notion:

In Marker.io, we only see Database 01:

Within Notion, select Database 02 > Settings (3 dots on the top right) > Connections > Add connections > Select Marker.io

Back on Marker.io, we refresh the Databases, and Database 02 is ready to select!


Invite your team to collaborate on a dedicated Notion project today with Marker.io, where anyone can report bugs and feedback in seconds. We have many advanced features for you to explore. See Marker.io Academy, which we continuously update with our latest features.

Did this answer your question?