# Notion (/docs/notion)



The Notion integration uses **OAuth** to connect your Notion workspace and sync articles into a database you choose. You control which Notion properties map to EarlySEO article fields.

Prerequisites [#prerequisites]

* A Notion workspace with a database for blog articles
* Permission to connect integrations in your Notion workspace
* An EarlySEO account

Setup [#setup]

1. Start the OAuth flow [#1-start-the-oauth-flow]

1. Go to **Integrations** in your EarlySEO dashboard
2. Click **Add Integration** and select **Notion**
3. Click **Connect with Notion**  you will be redirected to Notion to authorize

2. Authorize EarlySEO [#2-authorize-earlyseo]

In Notion's authorization screen:

1. Select the workspace to connect
2. Grant access to the databases EarlySEO should write to (or select "All pages")
3. Click **Allow Access**
4. You will be redirected back to EarlySEO

3. Select a database [#3-select-a-database]

After authorization, EarlySEO loads your available Notion databases. Choose the database where articles will be synced (e.g. "Blog Articles").

If no databases appear, click **Refresh**  Notion's API may take a moment to sync access.

4. Map fields [#4-map-fields]

Map your Notion database properties to EarlySEO article fields:

| EarlySEO Field            | Recommended Notion Property Type |
| ------------------------- | -------------------------------- |
| Title                     | Title property (required)        |
| Slug                      | Text / Rich Text                 |
| Meta Description          | Text / Rich Text                 |
| Publish Date              | Date                             |
| Article (Title + Content) | Title or Rich Text               |

**Required:** At least one property must be mapped to **Title** or **Article**.

EarlySEO auto-detects common field names (e.g. "Title", "Slug", "Date") and pre-fills the mapping for you.

5. Name and save [#5-name-and-save]

1. Enter a name for the integration (e.g. "My Blog Notion DB")
2. Click **Create Integration**

EarlySEO will now sync new articles to your Notion database.

Field Notes [#field-notes]

* **Article** field maps both the title and full content body into a single Notion page
* **Slug** maps to a plain text property  ensure your database has one if you need URL slugs
* Rich text fields in Notion receive Markdown-formatted content

Troubleshooting [#troubleshooting]

**Databases not loading**

* Click **Refresh Databases**  the Notion API sometimes needs a moment
* Ensure EarlySEO has access to the target database (re-authorize and re-grant access)

**"Please map at least one field to Title or Article"**

* Open the field mapping section and assign at least one Notion property to Title or Article

**Content not syncing**

* Check if the Notion integration still has access  re-authorize if the token expired