Popups

A popup is the panel that opens when a user clicks (or taps) a feature. By default it shows the layer's title and every field; the popup config lets you make it useful instead of a wall of text.

What you can configure

• Title template. Same {field} interpolation as labels. "{name}", "{name}: {status}", "Parcel #{parcel_id}".
• Body template. A rich-text body with {field} references, line breaks, bullet lists, links, optional images.
• Field list mode (alternative to body template). Pick which fields show, in what order, with optional per-field labels and formatting (date format, number precision, percent).
• Attachments section. For a data layer, tick Show attachments to list the feature's photos, signatures and files under the attributes. Pick Gallery (image thumbnails in a grid, other files as named tiles) or List (one row per file with its name and size). The files load when the popup opens, not on hover. Click a thumbnail or a name to open the file in a new tab.
• Related records. For a data layer with related tables (tables in the same data layer item that have this layer as their parent, such as inspections of an asset, and tables in other data layers linked under Structure → Relationships), tick each table to list under the attributes. For each one, pick the fields shown per row (default: the first three) and how many rows to list (up to 20). The rows load when the popup opens; when there are more, the section says "Showing first N".
• Actions. Buttons at the bottom of the popup, under the attributes. Zoom to is always there. In the map builder, on a data layer you may edit, the popup also offers: - Edit: opens the Edit feature panel beside the map, the same one the toolbar's Edit tool opens. It has the feature's attributes; its shape, which you change by dragging the vertices on the map; and its related records, where you open a row to edit or delete it, or Add a new one. Update saves the changed attributes and the shape together; related rows save on their own. - Delete: removes the feature after a confirmation. These are not configurable per layer yet.

How to set it

1. Open the map in the builder.
2. In the layer list, click Popup.
3. Pick a mode: None, Title + fields, Title + body.
4. Edit the title and body.
5. Pick fields and formatting (or leave defaults).
6. Toggle attachments / related tables / actions.
7. Save.

Disabling popups

A layer can have no popup, in which case the click does nothing. Useful for basemap-style reference layers where the features aren't interactive (parcel outlines under a thematic overlay, for example).

Notes

• Locations, photos and signatures are not attributes. A form submissions layer keeps a geopoint answer as a location and a photo or signature answer as a list of files. The popup leaves these out of All fields and Picked, and the field pickers do not offer them: the point is already on the map, and the files show in the attachments section.
• Popups don't render expressions. No conditional logic in the title or body. If you need "show 'Open' if status = 'O', 'Closed' otherwise," compute a derived column on the layer and reference that.
• Long bodies scroll. A popup has a maximum height; longer bodies get a scroll bar inside the popup rather than pushing the map.
• Mobile popups are full-width bottom sheets rather than floating boxes; the same template renders.