# Common questions and troubleshooting

Answers to common questions and the quickest routes to fixing things.

## No Notion source appears in the builder

- Is a **YOOtheme Pro template** active? Without YOOtheme there is no builder source.
- Is the plugin *System - Notion Source* enabled under *System → Plugins*?
- Is a **token** entered? Without a token the source is not loaded.

## The database selector is empty

- Is the token valid (starting with `ntn_` or `secret_`)? An invalid format is reported by the plugin when saving.
- Have you **shared** the databases with the integration? That is the most common reason — see [Setting up the Notion integration](https://docs.graup-it.de/books/notion-source-en/page/setting-up-the-notion-integration).
- Save the plugin again to rebuild the schema.

## A new Notion property is missing in the builder

The schema is read when the plugin is saved. After changes in Notion (new column, rename, newly shared database) **save the plugin once more** — the new fields are available afterwards.

## A field stays empty

- Does the field belong to the **selected database**? The builder shows the fields of all databases together; a field from elsewhere returns empty.
- For filters, is the **property name** exactly right (capitalisation, spaces) and does the chosen **property type** match the field in Notion?

## Changes in Notion appear with a delay

The API responses are cached for the configured *cache lifetime* (default 5 minutes). For faster updates lower the value; for an immediate test you can set it to 0 briefly (not recommended permanently on production sites).

## The update is not found or fails

- Click *Check for Updates* first to refresh the cache.
- Is the **download key** entered at the update site — and **without spaces** at the beginning or end? A space copied along with it leads to "Package download failed".
- If need be, download the new version manually and install it via *System → Install*.

## An image from Notion stops being displayed after a while

URLs hosted by Notion for uploaded files are time-limited. For permanent images use an external URL in Notion or the Joomla media manager.

<small>Applies to version 1.2.3.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/112)