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
- Go to notion.so/profile/integrations. Notion opens Developer tools → Connections. Click New connection.

Developer tools → Connections → New connection
- Name it SEO Sorted, choose API token as the authentication method, and click Create connection.

Name the connection and choose API token
- 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_.

Copy the API token and check the content capabilities
Step 2 — Add the connection to your blog page
- Open (or create) the Notion page your blog should live under — for example a page called Blog.
- Click ••• in the top right → Connections.

••• → Connections
- Search for SEO Sorted and select it.

Pick the SEO Sorted connection
- Notion lists what the connection can do on this page and its child pages. Click Add to page.

Confirm with Add to page
- Click ••• → Copy link to copy the page’s address.
Step 3 — Connect in SEO Sorted
Project Settings → Integrations → Notion → Connect.
The Notion connect form
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.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.
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 onStatus = Published. - After an unpublish, SEO Sorted forgets the page. Publishing the article again creates a new
page; the earlier
Draftpage stays in the database. - Deleting the article in SEO Sorted moves the page to Notion’s trash.
Tracking AI crawlers
Pages on anotion.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
“Notion rejected that secret…”
“Notion rejected that secret…”
The token was refreshed, or copied incompletely. Open the SEO Sorted connection under
Developer tools → Connections, copy the API token again and reconnect.
“That doesn't look like a Notion page link. Copy it with ••• → Copy link.”
“That doesn't look like a Notion page link. Copy it with ••• → Copy link.”
We couldn’t find a page id in what you pasted. Open the page in Notion, choose ••• →
Copy link, and paste that link unchanged.
“Notion can't see that page…”
“Notion can't see that page…”
The connection isn’t added to the page. Open it → ••• → Connections → SEO Sorted →
Add to page, then connect again.
“Your integration needs Read, Update and Insert content capabilities…”
“Your integration needs Read, Update and Insert content capabilities…”
Open the SEO Sorted connection under Developer tools → Connections, tick all three under
Content capabilities, and connect again.
Some formatting is missing
Some formatting is missing
Notion has no equivalent for raw HTML and nested lists deeper than two levels; those are
simplified. Everything else is converted to native blocks.

