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. You can choose between On widget load (default) or Real-time refresh modes.

For full details on how caching works and how to configure refresh modes, see Data Refresh.

Notion Page Content

Display the full body content of your Notion pages on detail pages — headings, paragraphs, lists, images, callouts, and more.

How it works

Notion databases store structured properties (title, category, date, etc.) and page content (the actual text and blocks inside each page). Shareables can render both:

Properties are displayed as fields on your cards and detail pages (this works automatically).
Page content renders the full Notion page body — everything you write inside the page in Notion.

Setup

Add the Notion Page Content field

In the creator, go to Content → Details → Fields. Click the Add Notion Page Content button below your fields.

Publish your database to the web

Your Notion database must be published to the web for page content to load. In Notion:

Open your database page
Click Share in the top right
Click the Publish tab
Click Publish to web

This makes all pages in the database accessible. You only need to do this once.

Reorder the field

Drag the Notion Page Content field up or down in the fields list to control where it appears on the detail page — above, below, or between your other fields.

If you see a yellow warning about publishing, your database is not yet published to the web. Follow the steps above to fix this.

Supported block types

Shareables renders most Notion block types:

Text — Paragraphs, headings (H1–H4), quotes, callouts
Lists — Bulleted, numbered, to-do checklists
Media — Images, video (YouTube/Vimeo), audio, files
Structure — Dividers, columns, toggles, toggle headings, tables
Code — Code blocks with language detection
Navigation — Table of contents, page links
Other — Equations, bookmarks, synced blocks

Inline databases are not currently supported.

Styling page content

Click the Notion Page Content field and open Notion Page Content Styling to customise:

Font size — Small, Medium, or Large
Heading color — Color for all heading levels
Text color — Color for paragraph and list text
Link color — Color for all links
Divider color — Color for horizontal rules
Checkbox color — Color for to-do checkboxes

You can also target any element with Custom CSS using the sh-notion-* class prefix.

Caching and refresh

Page content is cached for up to 1 hour. When a visitor loads a detail page:

If cached and fresh — serves instantly
If cached but stale — serves the cached version and refreshes in the background
If not cached — fetches from Notion (typically under 1 second) and caches for next time

Pages with Notion-hosted images use a shorter cache (50 minutes) since image URLs expire after about 1 hour.

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.

Page content not showing

If you’ve added the Notion Page Content field but content isn’t appearing:

Check that your database is published to the web — In Notion, open your database → Share → Publish → Publish to web
Check the warning icon — A yellow warning on the field in the creator means the database isn’t published
Make sure pages have content — Empty Notion pages won’t display anything (this is normal)
Wait for cache — If you just published, it may take a moment for the cache to update

Failed to fetch data

Check your internet connection and try again. If the issue persists, get in touch.