Exporting

Exporting is the standard publish flow: paste an import token, pick layers, and click Export. Each layer becomes a real layer in the target Topologis project.

Before you start, make sure you have:

• The plugin installed.
• An import token copied from the target project.
• Your layers and operations configured in the dialog.

If you don’t have a token and just want to see your data on a Topologis map, use Preview instead.

Paste your token

In the export dialog, paste the token into the Import Token field. The field masks its contents with stars; click it to reveal and edit the actual value, and click away to mask it again.

Underneath the field, the plugin shows which project the token belongs to and when it expires. If the project name looks wrong, you’ve grabbed the token from the wrong project, see Obtaining a token.

Run the export

With at least one layer ticked and a token pasted, the bottom-right button reads Export. Click it.

The dialog switches to a running state:

• The status line shows which layer is being processed and its phase (preparing... while the GeoJSON is being written, then a percentage while it uploads).
• The progress bar reflects overall progress across all selected layers.
• The bottom button becomes Cancel Export, which stops the run after the current layer finishes its in-flight HTTP request.

The upload runs on a background thread, so QGIS stays usable while it’s in flight. You can pan the map, edit layers, even open other dialogs.

What happens after success

When all layers are done, the dialog shows a one-line summary (for example, All 3 layers imported.).

If you left Open map in browser checked, your default browser opens to the map view for that project. Each published layer also shows up as an import job in the project’s Data tab and lands as a regular layer once processing completes.

If you ticked Replace existing for a layer, the existing Topologis layer keeps its id, styling, filters, tooltips, and any references that pointed at it. If you ticked Create new, a fresh layer is added alongside whatever was already there.

When something goes wrong

If a token has expired or is wrong, the export fails immediately, before any uploads start. The status line shows the error. Generate a fresh token (see Obtaining a token) and try again.

If a single layer fails partway through (a network drop during upload, an invalid geometry), the run continues with the remaining layers and the summary lists the failure. Hover the status line to see the per-layer error message. Re-running the export will retry just the layers that failed if you uncheck the ones that already succeeded.

For visibility into what the plugin actually sent and received, you can run QGIS with the TOPOLOGIS_DEBUG=1 environment variable. The plugin will write request and response details to the QGIS message log under the Topologis tag. Tokens are redacted, so the output is safe to share when filing a bug.