Notion Integration
Connect your Notion databases to create powerful, embeddable widgets.
Connecting Notion
Click Connect Notion
From the connection modal, click Connect Notion. If you’ve connected before, you can select a previous account from the dropdown.
Authorize with Notion
You’ll be redirected to Notion’s authorization page. Sign in and grant Shareables access to the databases you want to use.
Choose your setup method
You have two options:
- Start Fresh - Create a new database with sample data. Perfect for trying out templates.
- Use existing data - Connect to a database you’ve already set up in Notion.
Select your database
If using existing data, browse your available Notion databases and select the one you want to display in your widget.
Done!
Your Notion data is now connected and ready to display in your widget.
When authorizing, Notion lets you choose exactly which pages and databases to share with Shareables. You can update these permissions at any time from your Notion settings.
Start Fresh vs Use Existing Data
Start Fresh
Best for:
- Trying out a template quickly
- Learning how Shareables works
- Creating a demo widget
When you choose “Start Fresh”, we’ll:
- Create a new database in your Notion workspace
- Add the properties needed for the template
- Populate it with sample records you can customise
Use Existing Data
Best for:
- Displaying your real data
- Connecting to an established workflow
- Production widgets
Managing Multiple Accounts
You can connect multiple Notion accounts:
- Switch accounts - Use the dropdown to select a different connected account
- Add new account - Click “Connect new account” to add another Notion account
- Reconnect - If your connection expires, click the “Reconnect” button
Supported Property Types
Shareables supports all common Notion property types:
- Title - Used as the item title in your widget
- Rich text - Displayed as text content
- Number - Displayed as formatted numbers
- Select / Multi-select - Displayed as badges
- Date - Formatted date display
- URL - Clickable links
- Email / Phone - Contact information
- Files & media - Images displayed in your widget
- Checkbox - Boolean values
- Status - Displayed as badges
- Formula / Rollup - Computed values
How Data Refreshes
Your published widget uses smart caching to balance performance with data freshness.
How it works
- When a visitor loads your widget, they see the cached version for fast loading
- In the background, a request checks for updated data from your data source
- If new data is found, the cache is refreshed
- The next visitor (or page refresh) will see the updated data
Cache refresh rate
The cache refreshes at most once per minute, even if multiple visitors are loading your widget. This prevents excessive requests to your data source while ensuring updates appear quickly.
Forcing a refresh
Republishing your widget will immediately clear the cache, so the next visitor sees the latest data.
Troubleshooting
No databases found
Make sure you shared at least one database with Shareables during the authorization step. You can update shared pages in Notion under Settings & members > Connections > Shareables.
Database not appearing
If you added a new database after connecting, you’ll need to share it with the Shareables integration in Notion. Open the database, click the … menu, then Connections > Shareables.
Connection expired
Notion tokens expire periodically. If you see a “Reconnect” button, click it to re-authorize your account.
Failed to fetch data
Check your internet connection and try again. If the issue persists, get in touch.