Notion page sync

Sync the contents of Notion pages to write blog posts and more

About Notion Page Sync

Notion Page Sync is one of Whalesync's most powerful Notion features. As you might have guessed, it allows you to sync data from Notion pages to rich text fields in other apps!

This enables you to write entire blog posts in Notion and sync them instantly to your live blog or site. You can even use Notion AI to write these posts for you.

When to use Notion Page Sync

Notion Page Sync works best when Notion is the original source of your content. This is because Whalesync can reliably convert Notion's block-based format into HTML for other apps, and when that content is edited elsewhere, we can preserve and map it back to Notion's structure. However, the reverse isn't true—arbitrary HTML from other sources can't always be converted into Notion's proprietary block format. As a result, you might find that some of your styling or custom HTML is lost when sending updates back to your website.

If you only need content to flow into Notion from another app, try using a one-way sync on just the Page Content column or the whole table.

Notion page content vs. Notion records

A Notion database has a list of records. If you open one of those records, it opens up a page. That page is what Whalesync considers "Notion page content":

How to set up Notion page sync

To use Notion page sync, simply map the "Page Content" field on the field mapping page. This typically maps to a rich text field in other apps like Webflow.

Things to keep in mind

Notion page sync pairs really well with our Webflow Status field extension feature if syncing Notion -> Webflow

Notion page content supports 2-way syncing meaning you can sync content both from Notion to other apps and from other apps back to Notion

If syncing Notion pages to the Webflow CMS, some content may not appear in the Webflow CMS but WILL appear on your live site. Webflow's CMS doesn't always interpret HTML properly, but web pages will.

Shared OAuth settings: Notion OAuth has only one set of settings per Notion account, which means all your Whalesync bases will always share the same OAuth permissions. If you have multiple bases and reauthorize one of them (changing which databases you're sharing), it will automatically update the shared databases for all your other bases as well.

Performance with large databases: The Notion API is significantly slower than most other APIs that Whalesync integrates with. When syncing page content, Whalesync must make multiple API calls per page to fetch all the blocks and nested content. For databases with thousands of pages, this can result in long sync times. If you're experiencing slow syncs, consider moving the pages you want to sync into a smaller, dedicated Notion database with only the records you need. This reduces the number of API calls per polling round and can dramatically improve sync speed.

Page content limitations when syncing INTO Notion:

• 200 block limit: Each Notion page is limited to 200 blocks when syncing into Notion

• No style preservation: Classes and styles are not preserved when syncing into Notion

Supported blocks

If there are blocks or media formats that you need but do not see listed below, please reach out to [e-mail]. We are always looking for ways to improve the product!

How unsupported blocks are handled: Blocks that are not supported will be ignored during the sync process. These blocks will not be deleted or updated in Notion unless their parent object is deleted. They will simply remain unchanged in your Notion page.

Block	Status
📝 Paragraph	✅ Supported
💪 Headings (h1-h3)	✅ Supported
🖼️ Images (png, jpg, gif, svg, unsplash)	✅ Supported
🔗 Links	✅ Supported
📹 Video (mp4, ogg, webm, youtube, vimeo, wistia)	✅ Supported
⚫ Bulleted list	✅ Supported
⚪ Sub-bulleted list	✅ Supported
1️⃣ Numbered list	✅ Supported
🇦Sub-numbered list	✅ Supported
🎤 Quote	✅ Supported
⌨️ Code inline	✅ Supported
⌨️ Code block	✅ Supported
🔈Audio (mp3, ogg)	✅ Supported
☑️ To-do list	✅ Supported
➖ Divider	✅ Supported
⬇️ Toggle	✅ Supported
🔖 Bookmark	✅ Supported
📊 Table	✅ Supported
🗣️ Call outs	✅ Supported
📐 Column list/Column	✅ Supported
🔄 Synced blocks	✖️ Not Supported
📋 Template	✖️ Not Supported
🍞 Breadcrumb	✖️ Not Supported
📑 Table of contents	✖️ Not Supported
📄 Child page	✖️ Not Supported
🗃️ Child database	✖️ Not Supported
🔗 Link to page	✖️ Not Supported
🔗 Link preview	✖️ Not Supported
🔢 Equation	✖️ Not Supported
📎 PDF	✖️ Not Supported
📁 File	✖️ Not Supported
👇 Mention	✖️ Not Supported

Captions can be used to add alt text to images

We support the alt property on the image html tag and use the caption text for its value. We use the embed html tag for Unsplash images (because doesn't work otherwise) and the image tag for all other images.