Notion WP Sync Documentation

To install our Notion WP Sync plugin in WordPress, follow the steps below:

1. Download the plugin file to your computer
2. Log in to your WordPress dashboard.
3. On the left-hand side menu, click on Plugins and the Add New.
4. Click the Upload Plugin button at the top of the page.
5. Click the Choose File button and select the plugin file you downloaded in step 1.
6. Click the Install Now button.
7. Wait for the plugin to be installed, and then click the Activate button.

After installing and activating the plugin in WordPress, it will appear in the admin menu and access to the connection and configuration settings.

Before creating a connection, your are prompted to enter your license key to validate the installation of the plugin. To activate this license key, go to Notion WP Sync > Settings.

This license key is available both in your purchase confirmation email, as well as on wpconnect.co > My Account > My Downloadable Products > License Keys, View Licenses.

You will then be redirected to the purchase page of your product. Click on the key icon to see the license number appears and copy-paste it into your Notion WP Sync License Key field.

Once the license key is copied into the Notion WP Sync settings, be sure to click the Activate button. If your license key is valid, a green checkmark will appear and you juste need to save the settings by clicking the Update settings button.

You can then begin creating your connections.

To create a new connection to your Notion account, go to Notion WP Sync > All connections, click the Add New Connection button and enter a name for your connection.

You will be asked for an Internal integration token to connect your account. We recommand that you retrieve this token using this link or view this video.

For a better comprehension, please follow theses steps:

1. In your Notion account, go to the integrations page: Notion account > Connections > Develop or manage integrations.
2. Click the New integration button and enter a name for your integration. Then select the workspace where you want to use the integration in the Associated workspace field. Select “Internal” for the Type. And click on Save button.
3. Once the integration successfully created, click on Configure integration settings button: an Internal Integration Secret is already created.
4. Please select the Content capabilities “Read content” and the User capabilities “Read user information including email adresses“, and click on Save button.
5. Now, you can click on Show then Copy the Internal Integration secret. You can paste it into the Internal integration token field of your Notion WP Sync plugin.

⚠️ Once your Internal integration token has been entered in the field, you have to share your Notion pages or databases with your integrations to see their in the differents select fields of your plugin.
To do this, please select the more option button at the right top of your Notion page ou database, hover the Add connection option and select the connection you’ve just created. You can also consult the Notion Documentation Page to understand how to create an Internal integration token.

• Notion Pages: they are essentially digital documents that can contain a wide range of information, from text and images to embedded files, databases, and more.

• Notion Databases: one of the most powerful features of the Notion platform, Notion Databases are essentially tables with customizable columns, where users can input and manipulate data in a variety of ways

Here’s how these three elements work:

• Post: an article is a content that can be published on a blog or website. They are generally used to display information. They are created and managed in the Posts section of the WordPress dashboard.

• Page: a page is static content that is usually part of a website’s navigation menu. They are used to display information. They are created and managed in the Pages section of the WordPress dashboard.

• Custom Post Type (CPT): a custom post type is a custom content type that can be created by WordPress plugins or themes. CPTs allow you to add specialized content types to your site such as events, products, portfolios, etc. They are generally used to extend the capabilities of WordPress and to add structured content to your site. They are similar to posts and pages in that they can be published on your site and viewed by users but they have their own unique labels and characteristics that distinguish them. There are several types of CPTs: CPTs created by plugins or themes that you have installed on your WordPress site, those that you have created via plugin such as Custom Post Type UI or ToolSet or those that have been created manually by custom development.

For the Custom Post Type that you will create from the Notion WP Sync plugin, you will find the possibility of mapping the following WordPress fields: “Title“, “Content“, “Slug“, “Custom Field“.

It also allows you to create your own custom fields.

You can import your Notion content in shortcode.

Creating your shortcode content will create a Custom Post Type: “Notion Content“. This Notion Content CPT can be used by developers.

It can also be displayed thanks to our dedicated Notion Content block in Gutenberg editor.

The generated shortcode can be used in the shortcode bloc of Gutenberg or different builder pages like Divi, Elementor, WP Bakery, etc.

Like in WordPress, imported content from Notion can have different status: “Published”, “Draft”, “Scheduled”, “Pending”, “Private”.

Each of these status checks the following conditions:

• “PUBLISHED“ content is publicy visible on your website.
• “DRAFT“ content is saved as a work in progress and is not visible to the public.
• “SCHEDULED” content is set to be published at a specific date and time in the future.
• “PENDING” content is waiting for review or approval before it can be published.
• “PRIVATE” content is only visible to logged-in users with the appropriate permissions.

Depending on the status chosen, the synchronized content will receive the status defined in the settings.

If you decide to change the status in the configuration later, note that the change in status of already imported content will depend on the import strategy you have defined (see the different content import strategies).

You can also consider adding specific fields to your content imported from WordPress by mapping your Notion field to a custom field that you can name and which you will find in the imported content once the synchronization is complete.

Triggers allow you to control when data is imported from Notion to WordPress. There are three possible trigger options: “Manual“, “Recurring” and “Instant“.

• MANUAL: it allows you to manually import the data by clicking on the Sync now button. This is useful if you need to import data occasionally or want more control over when to import.
  
• RECURRING: it allows you to schedule the import of data at regular intervals. You can choose how often the import should occur, such as every “30 minutes”, “Once hourly”, “Once daily”, “Twice daily”, or “Once weekly”. This is useful if you want to regularly update your WordPress site with the latest content entered into your Notion workspace.
  
• INSTANT: it allows you to import data as soon as it is added or updated in Notion (depending on the selected import strategy). This is useful if you want your WordPress site to be in real-time sync with Notion, but it can also be resource-intensive if you have a large amount of frequently updated data.

Toggles are now compatible with Gutenberg!

Therefore, we have added support for toggles; however, since nesting is infinite on Notion, we have decided to limit it to the second level. You will therefore not be able to have more than 2 levels of toggles (that’s mooooore than enough).

Please see the example below:

Similarly, callouts are supported. However, you will not be able to nest one callout within another callout (well, one level is enough, right?).

Please see the example below:

1. ⚠️ Works
2. ⚠️ Don’t work