Notion
Tag Notion pages inside Cycle docs
Last updated
Was this helpful?
Tag Notion pages inside Cycle docs
Last updated
Was this helpful?
Many modern teams use Notion as their internal knowledge base to document market analysis, competitive research, and more.
Here's how to include your company's knowledge base in your product information.
Go to “Workspace settings” (or type "g" then "s")
Look for the “integrations” tab
Click on “Add new”, next to "Collaboration," and select Notion
Login to your Notion workspace & select the page hosting the Notion pages you will want to embed in your Cycle docs.
Product teams can seamlessly mention relevant Notion docs directly inside PRDs living in Cycle next to customer feedback.
Use the "/" command and search for the Notion integration.
Click it or press "enter" and type the three first letters of the Notion page you want to mention in your Cycle doc.
Once you mention a Notion page in Cycle, we'll add a backlink to the current Cycle doc at the bottom of the mentioned Notion page. This way, you'll always know which Cycle docs are related to your Notion pages.
Clicking a mentioned Notion page in Cycle will bring you straight to it.
Oh...almost forgot, it works both ways 😎.
Mentioning a Cycle doc in a Notion page will create a backlink to that Notion page inside the mentioned Cycle doc.
You can also embed a Cycle view inside a Notion page to share your product roadmap or a customer-specific board with other stakeholders.
Keep your Cycle and Notion roadmaps in lock-step
Link any Cycle doc to a Notion page and pull in its current Status
Listen for Status changes in Notion → automatically update the matching Cycle doc
Listen for Status updates in Cycle → mirror them back into Notion
A custom Notion URL property on your Cycle roadmap items
A Cycle API token with rights to read/write docs
A “Roadmap” database with at least two properties:
Status (type: Status)
Cycle URL (type: URL)
A Notion integration with a token, and the DB shared to it.
A publicly reachable HTTP endpoint (we use Google Cloud Functions in the example).
Click “+ New integration”, give it a name (e.g. “Cycle Sync”), and copy the Internal Integration Token.
Share your Roadmap database
Open the database in Notion.
Click Share → Connection and select your new integration.
Identify the database & property IDs
Via the Notion API or a tool like [notion-proxy], fetch the database schema.
Note down:
Database ID
“Status” property name (e.g. Status
)
“Cycle URL” property name and its property ID (you’ll need that UUID).
Create a Cycle API token
In Cycle, go to Settings → API and generate a new personal API key
Configure Cycle Webhooks
In Settings → API → Webhooks, add a new webhook pointing to your HTT endpoint for:
Event: Value changed
Event: Status changed
Define Notion URL attribute
Go to Settings → Properties
Add a new URL attribute named Notion URL.
Make sure it’s like to the type of the element you want to sync, rhis will hold the link back to the Notion page.
Ensure Status property exists
Go to Settings → Request
Select the desired type
Check you have the Status that you’d like
We’ll deploy a function that:
Listens for webhooks from Notion (page.properties_updated
).
Listens for webhooks from Cycle (value.change
& status.change
).
Uses the status–ID mappings to keep them in sync.
Get your Notion status names: e.g. "To do", "Doing", "Done" (The exact match)
Map the statuses in your favourite language
Go to [Notion → Settings & members → Integrations]. (Or )
Get your Cycle statuses view , you need the IDs
It could be , , no code tool like , or else.