Popups display information about map features when users interact with them. Customize what data appears, how it's formatted, and add interactive elements like buttons and images.
Accessing Popup Settings
- Select a layer in the Layers panel
- Open the Layer settings tab (right panel)
- Expand the Popup section
Popup Settings
Enable Popup
Toggle popups on or off for the layer. When disabled, clicking features shows no information.
Enable Editing
Allow users to edit feature attributes directly in the popup. When enabled, field values become editable inputs.
Position
Control where the popup appears relative to the clicked feature:
| Position | Description |
|---|---|
| Fixed | Popup appears in a fixed sidebar position |
| Floating | Popup appears near the clicked feature on the map |
Trigger
Define how users open the popup:
| Trigger | Description |
|---|---|
| On click | Popup opens when clicking a feature |
| On hover | Popup opens when hovering over a feature |
Size
Set the popup dimensions:
| Size | Description |
|---|---|
| Small | Compact popup for minimal information |
| Medium | Standard size for most use cases |
| Large | Expanded popup for detailed content |
Layout
Choose between automatic and custom content layouts:
| Layout | Description |
|---|---|
| Default | Automatically displays all fields from the dataset |
| Custom | Build your own layout with selected elements |
Default Layout
The default layout automatically shows all fields from your dataset in a list format. Each field displays its name and value for the selected feature.
This is the quickest option when you want to show all available data without customization.
Custom Layout
Custom layouts let you design exactly what appears in the popup. Add text, images, field lists, and interactive buttons.
Creating a Custom Layout
- Set Layout to Custom
- Click + Add element to add content
- Configure each element
- Drag elements to reorder them
- Click Save to apply changes
Custom Content Elements
Text
Add formatted text with dynamic field values:
- Click + Add element → Text
- Use the rich text editor to format content
- Click the { } button to insert field references
- Field references display the actual value for each feature
Rich text options:
| Tool | Function |
|---|---|
| { } | Insert field reference |
| B | Bold |
| I | Italic |
| U | Underline |
| ● | Text color |
| ¶ | Paragraph style |
| x² | Subscript/superscript |
| ≡ | Lists (bullet, numbered) |
| 🔗 | Insert link |
| ≡ | Text alignment |
Example: Create a custom title by inserting a field reference:
Tree ID: {tree_id} - {spc_common}
This displays as: "Tree ID: 570228 - littleleaf linden"
Image
Display an image from a URL field:
- Click + Add element → Image
- Select the field containing image URLs
- Configure display size and alignment
Images automatically load from the URL stored in each feature's field.
Field List
Show a selection of fields in a structured list:
- Click + Add element → Field List
- Select which fields to include
- Reorder fields as needed
Use this when you want to display specific fields rather than all available data.
Button
Add interactive buttons that trigger actions:
- Click + Add element → Button
- Configure the button in the dialog:
Setup tab:
| Setting | Description |
|---|---|
| Button text | Label displayed on the button |
| Action | What happens when clicked |
Available actions:
| Action | Description |
|---|---|
| Go to external URL | Open a link (can include field references) |
| Add form response | Open a form to collect data linked to this feature |
Options tab: Additional styling and behavior settings.
Example: Create a "View Details" button that opens an external system:
- Button text: "View in Database"
- Action: Go to external URL
- URL:
https://example.com/trees/{tree_id}
Managing Elements
- Reorder: Drag elements using the handle (⋮⋮) to change their order
- Remove: Click the × next to an element to delete it
- Edit: Click an element to modify its settings
Legend
Configure a visual key explaining map symbols and colors. See Legend for detailed customization options.
Required Fields
Mark specific fields as required when editing is enabled. Required fields must have a value before changes can be saved.
Best Practices
Keep Popups Focused
- Show only the most relevant fields
- Use custom layouts to highlight important information
- Avoid overwhelming users with too much data
Use Clear Labels
- Rename technical field names to user-friendly labels
- Add context with custom text elements
- Group related information together
Design for Your Audience
- Internal users: May need detailed technical data
- Public viewers: Prefer simplified, curated information
- Field workers: Benefit from editing capabilities and action buttons
Test Different Triggers
- On click works best for detailed popups with many fields
- On hover suits quick previews with minimal information