🚧

Heads up

Ensure to do the Initial Connection Setup once and then Manage the Connection by adding or unselecting pages directly from Notion.

The recommended approach to creating a Notion Connection is to provision a user [email protected] in your Google workspace and use that identity to connect Dust to your various data sources. The IT/CISO/(name the right function here) will update Dust data access using that account.
This will help them control what Dust has access to by managing the permission of that account on Notion.

If you cannot locate a specific Notion page in Dust, simply add it directly through Notion. To guarantee proper indexing and organization, link all parent pages to reestablish the page hierarchy.
Notion connections are unique per user, and replacing an existing connection with a new user's permissions disrupts the current data access.

Overview

Dust integrates with Notion to bring your workspace's pages and databases into Dust, allowing for a streamlined data-sharing and collaboration process. Due to permission restrictions, only Notion Admins can set up this connection.

Setting up the Connection

Initial Connection Setup

📘

User provisionning

The recommended approach to creating a Notion Connection is to provision a user [email protected] in your Google workspace and use that identity to connect Dust to your various data sources. The IT/CISO/(name the right function here) will update Dust data access using that account.
This will help them control what Dust has access to by managing the permission of that account on Notion.

The setup process requires a Notion Admin who is also a Dust Admin. This ensures full access to the necessary pages and databases that need to be shared with Dust. Follow these steps:

1. A Notion popup to give Dust your Notion workspace data (Teamspace selection).
2. A modal to select the exact data you want to sync with Dust.

Managing Permissions

• Adopt a shared-by-default approach—share everything except for the data you want to exclude from Dust.
• Use Notion's Top Page selection to share entire sections that are 100% sharable.
• Apply a more granular approach for sensitive pages, which will be classified under an Orphaned Pages folder in Dust.

🚧

Permissions

Each connection reflects the permissions of the last user to set it up. To prevent disruptions, avoid changing the designated admin or their permissions in Notion without reviewing the impact on Dust.

Updating the connection

• From Notion, navigate to the settings or page you wish to connect.
• Select the ... option, then choose Connect to and select Dust.

🚧

Missing pages

🚧 Notion API isn’t designed to ease sync with 3rd parties; some pages you think should be indexed can be missing.

Should a Notion page remain missing in Dust a few hours after direct addition: to guarantee proper indexing and organization, link all parent pages to reestablish the page hierarchy and check the permission of the page.
See the Best Practice section below.

Data Synchronization

• For new top pages: Refresh occurs once daily.
• For new pages within a synced top page or changes in an already synced page: Refresh is immediate, with a few seconds to minutes latency.

🚧

Large workspaces

Large Notion workspaces can take several days for the initial sync. Plan accordingly and monitor the process.

Best Practices

• Restrict Permission Management: To avoid accidental data access changes, limit the ability to manage Notion permissions to a single identified admin.
• Check if the page or Teamspace is restricted: Ensure the page or Teamspace is not restricted, otherwise Dust wont be able to index the data. If the Notion Teamspace is restricted, then all the child pages are as well.

• Admin Role Consistency: Ensure the designated admin has appropriate roles in Notion and Dust, with access to all necessary data.
• Orphaned Resources: Be mindful when adding pages without top pages to avoid misclassification under Orphaned Resources in Dust.
• Avoid Multiple Notion Connections: Ensure the designated admin is the only person to have a connection with the Dust app in Notion. Go to Setting & member > Connections > All connections. If you see your name +X, click on ...and delete all connections except from your admin connections.

Notion FAQ

Why do I see pages in Orphaned Resources?

When adding pages to Dust without their respective top pages, these get categorized as "Orphaned Resources" within Dust. This helps identify and manage pages that might not fit into the general hierarchy but still require syncing.

I added a Page or a Database, and I can’t see it.

Dust performs synchronization tasks based on the setup and permissions granted by the Notion Admin. The refresh rate varies depending on the type of content, its size, the size of the Notion workspace, and its location within the Notion workspace.

As an admin, go to the page and check Dust is connected. From Notion, select the ... option (top right), then choose Connect to and select Dust.

If the page is connected but you can’t see it 24 hours later:

• ping Dust over Slack or [email protected];
• write an email to Notion. This will help nudge them to improve their APIs to ensure their users can use third-party applications.

By following these guidelines, you can ensure a smooth integration between Dust and Notion, allowing for efficient data sharing and collaboration across your teams.