Views
Views define how a project is presented to other people.
In Topologis, a view is the unit you share or embed. It packages map presentation settings such as visible layers, filter behavior, map theme, starting camera, and embed layout into one saved output.
What a view is
A view belongs to a project and stores presentation choices for that project’s map.
The current view model includes:
- Visible layers
- View-specific filter behavior
- Per-layer style reassignment
- Layer toggle and hidden-by-default behavior
- Map theme and base feature visibility
- Starting camera
- Embed layout settings
- Optional PIN protection
Every project starts with a system Default View. That gives the project an immediate shareable output, even before you create custom views.
Create and manage views
You create and manage views from the Views list in the project editor.
The current view workflow supports:
- Creating a new view
- Renaming a custom view
- Duplicating a custom view
- Deleting a custom view
The system Default View is treated differently from custom views. It is created with the project and cannot be renamed or deleted from the views list.
Set the active view
The active view is the one the editor currently uses for preview and configuration.
Switching the active view lets you see the project through that specific presentation setup while you work. This is useful when a project needs more than one published output, such as one view for internal review and another for a public-facing embed.
Map style settings
Each view has its own map style settings.
The current map style controls include:
- A basemap theme
- Base feature visibility switches
Topologis currently exposes two basemap themes:
Dark MatterOSM OpenMapTiles
It also lets you toggle built-in map features such as boundaries, buildings, housenumbers, landcover, landuse, places, POIs, transportation, water, and related labels. This makes views useful for simplifying the map around the project data without changing the project itself.
Choose visible layers
Views control which project layers are included in that output.
For custom views, you choose the enabled layers directly in the Layers section. This is the first thing to configure after creating a new custom view, because the view decides which layers are part of that map.
The system Default View behaves differently. It shows the project’s layers as the base view, so if you need a narrower subset of layers, create a custom view.
Configure layer styles and toggles
Within a custom view, each enabled layer can be configured further.
The current per-layer view controls include:
- Assign a different existing style for that view
- Show a layer toggle control to viewers
- Hide the layer by default
This is not the same as editing the style itself. The view only decides whether that layer should keep its current style or switch to another existing project style for that output. If you need to change the underlying style definition, use Styles.
Layer toggle controls are especially useful for embeds, because they let viewers turn specific layers on and off without leaving the published map.
Configure filters for a view
Views also decide how layer filters behave in a published map.
For each layer filter, a view can control:
- Whether the filter applies in that view
- Whether the filter is exposed as a UI control to viewers
This separation matters. Some filters are useful as fixed conditions that always narrow the layer, while others should stay interactive in a shared or embedded map. If you need to build or edit the filters themselves first, use Filters.
Set the starting camera
Each view can control the map’s starting position.
The current camera options are:
Auto fit- Save the current map view as the starting camera
If Auto fit is enabled, Topologis starts from the automatic project extent. If you turn it off, you can save the current center, zoom, bearing, and pitch from the editor and use that as the starting camera for the view.
Share and embed from a view
Sharing and embedding both happen from a specific view.
For sharing, Topologis gives each view its own shareable link at /view/{viewId}. A view can also be protected with a 6-digit PIN. If PIN protection is enabled, visitors need to enter that PIN before the shared view loads.
For embedding, Topologis provides:
- A script tag that loads the embed runtime
- A container element for the map
- Embed layout settings for
landscape,square, orportrait Fill widthandFill heightoptions
If both Fill width and Fill height are enabled, the aspect ratio setting is ignored. Embeds also depend on the workspace’s allowed host configuration. If the current site host is not allowed, the embed script will not load that view.