Notion Integration

Efficient website feedback with Notion in a few simple steps.

Joe Scanlon avatar
Written by Joe Scanlon
Updated yesterday

Ready to get detailed website feedback reports directly into Notion? Thanks to Marker.io when your team and clients find issues - they can annotate these directly on your website. No need to ask clients to install anything and your team will receive a detailed report directly into Notion. Check out the details below on how to set this up.

Set up a Notion Integration

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

Create a Marker.io 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

Allow Marker.io to access your Notion database

Configure forms

We fetch your native Notion fields into your widget form. You can show/hide any fields and preset those fields if required. 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 the WordPress plugin, NPM package, or send a request to your developer in one click. See our Widget Installation Guide for more details.

Now, anyone that can view your website, whether it's in a staging or a live environment, will see the Marker.io feedback widget.


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 feedback

You can now review your feedback both in Marker.io and in your Notion project.

In Notion you see the feedback arrive with a clear screenshot and automatically captured technical data your team will appreciate to help fix any problems.

  • Page URL

  • Browser

  • Screen size

  • Operating system

We also provide links to Console Logs, Network Requests as well as a Session Replay video of what your reporter did just before submitting the feedback. Create to help your developer team understand the complete context of the issue.

Communicate with reporters

The "Contact via Marker.io" link opens the Feedback Page, where you can communicate with your reporters. They will receive an email where they can reply. All conversations will be synced directly with Notion.

Synchronize Status

This feature is not currently available on our Notion integration. We are waiting on Notion to release their Webhooks feature. If you would like our team to build this out, please consider voting on that feature request here:

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

  • 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.

  • Reset your password in Notion

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

  • 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 project

    • 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.

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

Back on Marker.io, refresh and your database should be now available.

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

We have received some information from Notion developers as regards the Relation field:

One-way relations are basically backlinks to linked pages. They do not represent 'relation' in that sense as the 'linked' page aren't related to the page origin.

Because of this, you need to ensure that the sync is a two-way relation for it to appear as a field on Marker.io.

Note: You must ensure you share both databases with Marker.io as outlined above.

Below, for example, Database 01 has a Relation Type (field) relating to Database02.

Now we need to ensure that the Relation is two-way, so we click on Edit property and ensure that Show on Database 02 is toggled on as below.

For more details on the Notion two-way relation, check out the following article from Notion:

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

To effectively manage feedback within Notion by organizing it as subtasks under a primary task, follow these detailed steps to enable and utilize parent and subtask functionalities. This approach can help improve how feedback, such as bug reports, is categorized and addressed.

Enabling Subtasks in Notion

  • Navigate to the top right corner of your Notion table and click on the three dots to access the settings menu.

  • In the settings menu, look for an option to enable sub-items. Turn this feature on to allow the creation of hierarchical task relationships within your database.

Enabling subtasks will introduce 'Sub-item' and 'Parent Item' fields in your Marker.io forms.

Decide whether these fields should be pre-selected and hidden from reporters, or if they should be editable. This decision will depend on how you prefer to manage the workflow. Allowing reporters to edit these fields can encourage more detailed feedback, but may require additional moderation.

An example below where we allow the reporter to select the parent item

Below is a Notion example of a Parent item: All Bug Reports, and a sub-item: Button Broken

Tips for Managing Workflow

  • Experiment with Settings:

    • Adjust the visibility and editability settings of the parent and sub-item fields to find the best setup that suits your team’s workflow.

  • Regular Review:

    • Periodically review the configuration to ensure it meets the evolving needs of your project or team.

By structuring your feedback as subtasks under a designated parent task within Notion, you can enhance organization, improve tracking, and streamline the resolution process. Experiment with these settings to choose the right setup for your needs.


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?