Notion page sync

About Notion Page Sync

Notion Page Sync syncs the content of Notion pages to rich text fields in other apps.

This enables you to write entire blog posts in Notion and sync them 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

Note

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

Note

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 your sync connected Notion before October 2025, its Page Content field is read-only and reauthorizing Notion won't change that, so contact support@whalesync.com to turn on two-way syncing for it.

Note

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.

Caution

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.

Caution

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.

Caution

Page content limitations when syncing INTO Notion:

• 300 block limit: Each Notion page is limited to fewer than 300 top-level blocks when syncing into Notion
• 1-Way blocks: Blocks marked 1-Way in the table below don't sync back. When page content syncs into Notion, toggles, Unsplash images, and video and audio files are removed from the page, a column list becomes a single callout, and a YouTube video's link is replaced with one that later syncs can't read
• 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 support@whalesync.com. We are always looking for ways to improve the product!

Note

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. Mentions are the exception: they sync to other apps as plain text, and when page content syncs back into Notion, that text replaces them.

Block	Status
📝 Paragraph	✅ Supported
💪 Headings (h1-h3)	✅ Supported
🖼️ Images (png, jpg, gif, svg)	✅ Supported
🖼️ Images (unsplash)	➡️ Supported (1-Way)
🔗 Links	✅ Supported
📹 Video (youtube)	➡️ Supported (1-Way)
📹 Video (vimeo, wistia)	✅ Supported
📹 Video (mp4, ogg, webm)	➡️ Supported (1-Way)
⚫ 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 (1-Way)
☑️ To-do list	✅ Supported
➖ Divider	✅ Supported
⬇️ Toggle	➡️ Supported (1-Way)
🔖 Bookmark	✅ Supported
📊 Table	✅ Supported
🗣️ Call outs	✅ Supported
📐 Column list/Column	➡️ Supported (1-Way)
🔄 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

Note

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 (the image tag doesn't work for them) and the image tag for all other images.