Entering the token and options
Notion Source has two settings. You find them under System → Plugins → System - Notion Source.
Notion integration token
Paste the token you created in Notion here (it starts with ntn_ or
secret_). Without a valid token the builder offers no Notion source.
Cache lifetime (seconds)
For this long the answers of the Notion API are cached before they are fetched again. The default is 300 (five minutes). A higher value relieves the API and speeds up the pages; a lower value shows changes in Notion sooner. The value 0 switches the cache off — not recommended on production sites.
What happens when you save
On saving, Notion Source reads the property schema of all shared databases and stores it locally. If that succeeds, a green message names the databases found, for example:
Notion Source: schema loaded – Team (6 fields), References (9 fields)
The builder then offers the fields from this schema — without querying the API on every page view.
After changes in Notion — when you add or rename a property (column) or share a new database — save the plugin once more. Only then is the schema updated and the new fields appear in the builder.
If no token is entered
If you remove the token and save, the schema cache is deleted and the Notion source disappears from the builder. If the token format is invalid, the plugin says so on saving and does not build the schema.
Applies to version 1.2.3.