Show a Notion database in a widget
Connect a Notion database so your widget shows its entries, like FAQs, listings or a schedule, and updates when you edit the database.
Connect Notion when you keep content in a Notion database, like FAQs, job listings or a class schedule, and want your widget to show it. When you edit the database, the widget shows the change the next time the page loads.
The connection only reads from Notion. Your widget can't add or change entries.
Before you start
You need a Notion integration secret, and the database has to be shared with that integration.
- In Notion, go to notion.so/profile/integrations and create a new internal integration for your workspace. Name it something like "Embeddable".
- Under capabilities, Read content is enough.
- Open the Access tab and give the integration access to the database you want to show.
- Open the Configuration tab and copy the Internal Integration Secret.
- Open the database as a full page and copy its link. The database ID is the long string of letters and numbers in the link, before any
?v=.
Connect it
- Open your widget in the editor.
- In the AI chat, ask for it, for example "Show the entries from my Notion database".
- A connection card for Notion appears in the chat. Paste your secret into the Notion integration secret field and click Save.
The card shows Connected. For the general steps, see Connect an app to your widget.
Choose the database
The card saves your secret, but the widget also needs to know which database to read.
- In the editor, click More, then Connect apps.
- Find Notion and click Edit.
- Open Fetch dynamic data from Notion and paste the database ID into Database Id.
- Click Update.
What happens next
Tell the AI chat what to show, for example "Show each entry as a question and answer, using the Question and Answer properties." Check the preview, then publish your changes.
The widget reads up to 100 entries from the database.
Remove it
- On the connection card in the chat, click the trash icon. Or click More, then Connect apps, open Notion and click Disconnect.
- Your secret stays saved in your workspace so you can use it again. To stop all access, remove the integration's access to the database in Notion, or delete the integration at notion.so/profile/integrations.
If your entries don't show up, check that the database is shared with your integration on the Access tab. If it still doesn't work, email us through the contact page.
Did this answer your question?
Your feedback helps us improve.
