Home
Download Instructions Changelog/New Features Account

Setup Instructions

This guide walks you through connecting your WordPress site to Notion using the Notion Sync plugin. Follow each step carefully to complete the integration and begin syncing content.

Step 1: Download and Install the Plugin

Go to the Download page and download the latest version of the Notion Sync plugin as a .zip file.

Then install it in WordPress:

  1. Log in to your WordPress admin dashboard.
  2. Go to Plugins > Add New.
  3. Click Upload Plugin.
  4. Choose the downloaded notion_sync.zip file and click Install Now.
  5. Click Activate Plugin once the installation is complete.

Need help? See the official WordPress guide: Installing Plugins via Admin

Step 2: Create a New Database in Notion

In your Notion workspace, create a new database to store synced content. You can use either a table, board, or list view.

  1. Open Notion and click + New Page.
  2. Choose Table or another database layout.
  3. Give the database a descriptive name, such as "WordPress Sync".
  4. Copy the Database ID of your database. To find your Database ID, refer to Notion's Official Documentation

Step 3: Connect to Notion via OAuth

From the WordPress admin area:

  1. Go to Settings > Notion Sync > Manage Access.
  2. Click the Connect to Notion button.
  3. A secure OAuth window will appear. Log in to your Notion account when prompted.
  4. Select the workspace and database you created earlier.
  5. Grant permission for "Sync Assist" to access the database.

Sync Assist is the integration that allows the plugin to create and update pages in the database on your behalf.

Step 4: Share the Database with the Integration

To allow syncing, Notion requires that you explicitly share your database with the integration you authorized:

  1. Open the database in Notion.
  2. Click the Three Dots in the top right.
  3. Under Connections, choose Sync Assist.
  4. Click Yes when prompted.

This ensures that your integration has access to write to the database you specified.

More info: Add & manage integrations

Step 5: Enter Your Database ID

Back in the Notion Sync plugin settings page, you’ll see a field labeled WordPress Database ID.

  1. Paste the Database ID you copied earlier into this field.
  2. Click Save Changes.

Step 6: Start Syncing

You're now ready to sync content!

  1. Go to the Notion Sync menu in WordPress.
  2. Click Sync Now to begin transferring posts to Notion.
  3. Check your Notion database — entries should appear in real time.

Note: This may take some time to complete depending on the size of your website. Please do not click 'Back' or 'Refresh' in your browser until the sync has completed.