Notion

Unblocked exists to answer questions about your application, so it takes into account the context, data, and discussions that live across the systems your team uses. When you connect Unblocked with your Notion workspace, you’ll provide Unblocked with important context on how and why your codebase works. Unblocked will be able to use the details in your Notion workspace to answer questions you ask, and it will provide links back to the pages it used to find those answers for easy reference.

​

Connect your Notion workspace

​

Sign in to Unblocked

Whether you sign in with a source code manager or your SSO provider, you first need to authenticate to Unblocked.

Once you’ve signed in, click Data Sources in the sidebar, and then the Add Sources tab. Scroll to the documentation section and select Notion.

You’ll be redirected to Notion to sign in and confirm the workspace you intend to use with Unblocked. In the top right menu, select the workspace you want Unblocked to access. Then, click Select pages.

​

Selecting Notion pages

Notion will ask you to select the pages you want to include in your team’s data index. If you select a parent node on this page, any pages added to that space in the future will be automatically indexed by Unblocked. If you select individual pages, then you will need to return to Notion any time you want to grant access again.

Click Allow access. You’ll be brought back to Unblocked. From there, Unblocked will use any of the pages you’ve selected in Notion to answer your questions.

​

Configuring or updating access to Notion

Page access in Notion can only be controlled by the person who first granted access. Therefore, if you need to make any changes to the pages shared with Unblocked, you will need to have the person who set up the integration make those changes. This is why we display who connected Notion to your Unblocked instance on the data source page.

If you need to override the settings, and the person who did the initial configuration is unavailable, you can delete the integration and restart the configuration process. Otherwise, the person who performed the initial configuration can follow these steps.

After logging into Notion, select Settings & members from the Notion sidebar. This will open a modal menu, where you can click My connections to open integrations you’ve configured with your Notion workspace.

At the right side of the Unblocked connection, click the three dot menu and hover over Access selected pages. This will open another modal menu where you can modify the documents to which you have given Unblocked access. Make the necessary changes, and then click Update access.

You can now return to Unblocked, and it will use the updated pages you’ve selected as a source for answers.