Skip to main content
The Notion connector writes each published article as a page in a Notion database that we create for you. If your blog is served from Notion (Super.so, Feather, Potion, Notion Sites), articles appear on your site as soon as they sync.

Before you start

  • You need to be a Workspace Owner in Notion to create a connection.
  • Decide which page your blog lives under — we create the articles database inside it.

Step 1 — Create a Notion connection

  1. Go to notion.so/profile/integrations. Notion opens Developer tools → Connections. Click New connection.
Notion Developer tools page on the Connections tab with the New connection button highlighted

Developer tools → Connections → New connection

  1. Name it SEO Sorted, choose API token as the authentication method, and click Create connection.
New connection dialog with the name SEO Sorted, API token selected and the Create connection button highlighted

Name the connection and choose API token

  1. On the connection’s Configuration tab, make sure Read content, Update content and Insert content are ticked under Content capabilities. Then copy the API token with the copy icon — it starts with ntn_.
SEO Sorted connection configuration showing the Integration token card and Read, Update and Insert content ticked

Copy the API token and check the content capabilities

Step 2 — Add the connection to your blog page

  1. Open (or create) the Notion page your blog should live under — for example a page called Blog.
  2. Click ••• in the top right → Connections.
Notion page menu open with Connections highlighted

••• → Connections

  1. Search for SEO Sorted and select it.
Connections search box with SEO Sorted typed and the SEO Sorted connection highlighted

Pick the SEO Sorted connection

  1. Notion lists what the connection can do on this page and its child pages. Click Add to page.
Add SEO Sorted to this page dialog listing read, insert and update content, with Add to page highlighted

Confirm with Add to page

  1. Click ••• → Copy link to copy the page’s address.

Step 3 — Connect in SEO Sorted

Project Settings → Integrations → Notion → Connect.
Connect Notion dialog with setup steps and Integration secret, Notion page link and Site URL (optional) fields

The Notion connect form

string
required
The API token from step 1. Stored encrypted.
The link from step 2.
string
If Super, Feather or another tool serves this database as your blog, enter its address. The live link we show after publishing is then Site URL + /blog/ + the article slug (for example https://yoursite.com/blog/my-article). Leave it empty and the link points at the page on notion.so instead.
We check that the integration can see the page, then create an inline database called SEO Sorted articles inside it. Reconnecting to the same page reuses that database.

Step 4 — Publish

Open an article, click Publish, then Publish now next to Notion. The dialog confirms Article Published — “Synced to your Notion database” — with a View article button.

What gets published

The page body is the article: headings, paragraphs, lists, quotes, code, tables, images and YouTube videos become native Notion blocks. The article’s JSON-LD schema is not sent — Notion has nowhere to put it.
Don’t edit synced pages in Notion. A re-publish replaces the page body and properties with the SEO Sorted version. Make edits in SEO Sorted and re-publish.
Notion’s API allows about three requests a second, so a long article can take up to a minute to sync. That’s expected.

Re-publishing, unpublishing and deleting

  • Re-publish updates the same page in place. If the page was deleted in Notion, a new one is created.
  • Unpublish sets Status to Draft — filter your blog tool’s view on Status = Published.
  • After an unpublish, SEO Sorted forgets the page. Publishing the article again creates a new page; the earlier Draft page stays in the database.
  • Deleting the article in SEO Sorted moves the page to Notion’s trash.

Tracking AI crawlers

Pages on a notion.site address can’t be tracked, because the domain isn’t yours. If another tool serves your Notion pages on your own domain, check Which option to pick for that host.

Common problems

The token was refreshed, or copied incompletely. Open the SEO Sorted connection under Developer tools → Connections, copy the API token again and reconnect.
The connection isn’t added to the page. Open it → ••• → Connections → SEO Sorted → Add to page, then connect again.
Open the SEO Sorted connection under Developer tools → Connections, tick all three under Content capabilities, and connect again.
Notion has no equivalent for raw HTML and nested lists deeper than two levels; those are simplified. Everything else is converted to native blocks.