Preview your data
Every Spatibase project has its own map page that shows the project’s published entries the way a visitor sees them: a full-screen map on your project’s map style, a small panel with the project’s name, types and entries, and all the details of an entry when you select it. This page explains how to open it, what it shows, who can see it and how to link to a particular view. You need no code and no API key for it.
How do I open the preview?
- Open the project menu (the project name at the top of the sidebar) and choose Preview data.
- Or press ⌘K (Ctrl+K on Windows) and choose Preview data.
- Or copy its address from API → Maps & tiles, where Preview page is the first row under Map data.
The preview always opens in a new tab, so anything you are editing stays as it is. Its address is https://app.spatibase.com/view/<project-id>, where the project id is the one in your project’s address in the web app.
What does the preview show?
- The map: every published entry with a location, drawn in its type’s colour: points, lines and areas. Zoom with the mouse wheel, a double click or a pinch. The map stays around your data: you can’t move it far away from the entries or zoom out past a view a little wider than all of them.
- The project panel (top left): the project’s name and description (More shows a long description in full), how many entries are shown, a list of your types with how many entries each has (when there are two or more), and a list of all the entries. Subtypes sit indented under their parent type. Types without a map location or without a published entry are not listed.
- An entry’s details: select an entry on the map or in the list to open a card with all of its fields, read-only. Empty fields are left out. The card stays open while you move the map; close it with its close button or Esc. A field that points to another entry opens that entry in the card. At the bottom of the card, Copy JSON copies the entry as the API returns it, and on a public project View as JSON opens that entry in the API.
The panel never grows taller than the window: a long list scrolls inside it, and a soft fade at the edge shows there is more. On a phone the panel sits at the top of the screen and starts folded to the name; an entry’s details open as a sheet from the bottom.
How do I find an entry?
The Entries list in the panel holds every entry on the map, sorted by title, each with its type’s colour. Select one to open its details; the map moves to it. With more than 20 entries a Filter entries box appears above the list: type part of a title to narrow it down. The panel lists only entries of the types that are shown on the map. Keyboard users can Tab to the list, move with the arrow keys and press Enter to open an entry.
How do I show or hide a type?
Select a type in the panel’s list to hide it from the map; select it again to show it. Hiding a type also hides its subtypes and takes its entries out of the Entries list. While something is hidden, the count shows how many entries are still on the map and Show all brings everything back. Selecting the Types heading folds the type list away. Selecting the project’s name at the top of the panel folds the whole panel down to the name, and the preview remembers that in your browser (one setting for every project).
Why is my latest change not on the preview?
The preview shows only what is published, the same content your website or app gets from the Content Delivery API. Drafts and unpublished changes are not on it, for members either. Mark the entry ready and publish the project (see Drafts and publishing), then reload the preview. Entries of types without a location, and of types switched off for the API, never appear on the map.
Who can open the preview?
It depends on the project’s access setting (see Access and API keys):
- Public project: anyone with the link can open the preview. At the bottom of the panel, Build with AI copies a ready-made prompt for an AI coding agent (Claude Code, Codex, Cursor) that builds an app on this data: add what you want to build and paste it into the agent. Signed-in members also see Open, which takes them back to editing in the workspace. Visitors see Duplicate on a public dataset, to copy it into their own account, and Try free on any other project.
- Private project: only signed-in members of the project, in any role, see the map, with a note in the panel that only members can see the page, and Open to go back to editing (no AI prompt: the data needs a key). Everyone else sees “This project is private” with a Sign in button (Sign in with another account if they are signed in but not a member), and no data from the project, not even its name. The preview never uses an API key and never puts one in a link.
A public project you later switch to private shows the private message on its old links from then on.
Search engines are asked not to list preview pages.
How do I link to a particular view?
The preview keeps what you look at in its address, so you can copy the address from the browser and send it:
| Part of the address | What it does | Example |
|---|---|---|
?entry=<entry-id> |
Opens that entry’s card and moves the map to it | /view/<project-id>?entry=<entry-id> |
?types=<apiKey>,<apiKey> |
Shows only these types (and their subtypes) | /view/<project-id>?types=playground,museum |
#<zoom>/<lat>/<lng> |
Opens the map at this position | /view/<project-id>#13/48.2082/16.3738 |
The type names in ?types= are the types’ API keys, which you find in Content model or in API → Types & fields. Without a position in the address, the preview opens at your project’s dashboard thumbnail view (see Map style), or else at the area your entries cover.
Can I embed the preview in my website?
Not yet: the preview is a page of its own and cannot be placed inside another site. To show your entries on your own map, use the vector tiles or GeoJSON; the Maps & tiles page in the app has ready-to-copy examples.
Related
Updated