Sync Notion pages into shared Team Hub Topics so documentation is easy to find. This guide is for Account Admins, Team Admins, and Experts.
ℹ️ Before you start: Notion must be connected before anyone can sync pages. To connect, see Connect Notion. Notion syncs into Team Hub only, not Deal Rooms.
1. How to sync pages
Choose the specific pages to bring into Spekit. Only what you select is synced.
- Open the Spekit Hub (Web App) or the Sidekick (Chrome Extension).
- Click the Team Hub button, then click + Add New (or open Content), and choose Sync Files.
- Open the Notion filter tab. All the Notion pages you have access to appear here.
- Select the pages you want to import.
- Assign the pages to the relevant Spekit Topic(s) so they are organized and easy to find.
- Click Sync pages to finish.
ℹ️ NOTE: Spekit syncs from Notion about once an hour. A change you make in Notion appears in Spekit after the next sync. If you delete a page in Notion, it is removed from Spekit on the next sync.
2. How synced content appears in Spekit
Notion syncs like Confluence. Spekit ingests and indexes the page content, but does not render the page inside Spekit.
| Feature | Behavior |
|---|---|
| Content in Spekit | Spekit ingests and indexes the page content, so it is searchable and available to the AI Sidekick. |
| Display | The page does not render inside Spekit. Open the live page with the View in Notion button. |
| AI Sidekick and search | Can reference and surface the synced page content, the same way it does for Confluence. |
| Permissions | Only users with Notion access can open the full page. |
| Formatting | Custom Notion rich-text components and Notion-only markdown are not supported. |
In the Content list, synced Notion pages appear as cards with a PAGE label and the Notion icon, and you can filter by Content source: Notion.
3. How to test your integration
After your first sync, confirm everything is routing correctly.
- Go to Content and filter by Content source: Notion to see your synced pages.
- Open a page and confirm the View in Notion button opens the right page.
- Ask the AI Sidekick to reference a synced page, and confirm it shows Notion as the source.
4. Best practices
These build on the general syncing best practices in the Content Syncing Overview. Because Notion content is indexed but opens in the source to read, the habits below are specific to Notion.
| Best practice | Why it matters |
|---|---|
| Make titles descriptive | Clear titles help people spot the right page in results. The page content is indexed too, so search can also match on the body. |
| Confirm Notion access matches your audience | A user who lacks access in Notion can see the page in Spekit but cannot open it. Before you rely on a synced page, make sure the people who need it can open it in Notion. |
| Grant at the top-level page | Notion shares everything nested under a page you grant. Granting a well-organized top-level page brings its sub-pages along, so you do not have to add each one. |
| Reserve Notion for reference documentation | For content reps need to read, present, or share with buyers inside Spekit, sync the file from Google Drive or SharePoint instead. Use Notion for internal reference material that lives naturally as a page. |
| Use a Spek when reps need to read or share it inside Spekit | Synced Notion content is searchable and AI-readable, but it opens in Notion to read. If reps need to read, present, or share the content inside Spekit, copy it into a Spek. |