Obtaining a token

To publish into a Topologis project, the plugin needs an import token. The token tells the plugin which project to upload into and authorizes it on your behalf.

If you just want to try the plugin without creating an account, you can skip this page and use Preview instead.

Where to find the token

Tokens are scoped to a single project, and they live in the project editor.

1. Open the project you want to publish into.
2. Switch to the Data tab.
3. Click Import Data, then From QGIS.

A dialog opens with the token for that project. Copy it.

Paste it into the plugin

Open the export dialog in QGIS (Web → Topologis Exporter → Publish to Topologis..., or the toolbar icon) and paste the token into the Import Token field.

The plugin remembers the token between QGIS sessions, so you only need to copy it again when it expires.

Underneath the field, the plugin shows which project the token belongs to and how many days until it expires. If you have access to multiple projects, this is the easiest way to confirm you copied the token from the right one.

Lifetime and rotation

Tokens are valid for 30 days. Once a token expires, the plugin will start failing on upload. Open From QGIS again to grab a fresh one and paste it back in.

Treat the token like a password

Anyone who has the token can push layers into the project. Don’t paste it into shared chats, screenshots, or public repos.

The plugin stores the token in QGIS’s settings (QSettings) without encryption, the same trust model other QGIS plugins use for API keys. If you share your QGIS profile with someone, they can read the token from it.

Next step

With a token pasted, you’re ready to pick layers and run the export. See Configuring an export.