Skip to main content

Setting up the Notion integration

Deutsche Fassung

For Notion Source to read your databases it needs an integration token from Notion and the databases in question shared with that integration. You set up both in Notion — once, and in a few minutes.

1. Create an internal integration

  1. Open notion.so/my-integrations and click New integration.
  2. Give it a name (for example "Website") and select the workspace it belongs to.
  3. An internal integration with read permissions (Read content) is enough. Write permissions are not needed.
  4. Save and copy the Internal Integration Secret shown. It starts with ntn_ (with secret_ for older integrations).

This token is a key to the shared content of your workspace. Treat it like a password and do not pass it on.

2. Share databases with the integration

A fresh integration sees nothing — you have to share every database (or a parent page) with it explicitly:

  1. Open the database in Notion as a full page.
  2. Click ••• at the top right → Connections → Connect to and choose your integration.
  3. Repeat this for every database that is to appear on the website. If you share a parent page, the databases below it count as shared automatically.

Whatever you do not share with the integration does not show up in Notion Source. If too few databases — or none at all — are offered in the builder later, this sharing step is almost always what is missing.

Back to Joomla

Now enter the copied token in the plugin — see Entering the token and options.

Applies to version 1.2.2.

Back to top