Configuring Fields
Set up and configure the data fields that power your map.
What are fields?
Fields define the schema for your map's data. Each feature (marker or point) on your map has values for each field you configure. Think of fields as columns in a spreadsheet — they describe the structure of your data.
For example, a store locator map might have fields for store_name, address, phone, and category.
Adding fields
In the map editor, go to the Fields section. Click Add Field to create a new field with the following properties:
- Label — The display name shown in forms, card templates, and the editor UI.
- Slug — An auto-generated URL-safe identifier derived from the label. Used in the API and in templates (e.g.,
company_name). Slugs are lowercase with underscores. - Type — The data type for this field. See Field Types for full details.
- Weight — Controls the display order of fields in the editor and forms. Lower weight appears first.
Field types overview
Mapsemble supports the following field types:
| Type | Description |
|---|---|
text |
Single-line text value |
multiline_text |
Multi-line text, supports longer content |
number |
Numeric value (integer or decimal) |
date |
Date value, supports date ranges |
image |
URL to an image |
single_select |
One option from a predefined list |
multi_select |
Multiple options from a predefined list |
Configuring select fields
For single_select and multi_select fields, you define a set of options. Each option has:
- Label — The human-readable text displayed to users.
- Value — The stored value used internally and in the API.
For example, a "Category" field might have options like:
| Label | Value |
|---|---|
| Restaurant | restaurant |
| Coffee Shop | coffee_shop |
| Bar | bar |
Using fields in templates
Reference fields in your card and popup HTML templates using the token syntax {{field_slug}}. Mapsemble replaces these tokens with the feature's actual values at render time.
<h2>{{company_name}}</h2>
<p>{{description}}</p>
<img src="{{image}}" alt="{{company_name}}">
Multi-select display
multi_select fields are iterable. Individual items can be formatted for display, making it easy to render tags, badges, or comma-separated lists.
Number formatting
Number fields support integer and decimal display formats. You can configure custom formatting to control how numeric values appear in your templates.
Date fields
Date fields support date ranges with from and to values, making them useful for events, availability windows, or any time-bound data.
Image fields
Image fields store URLs pointing to images. They can be used in card and popup templates to display photos, logos, or icons. Image fields can also drive image-type markers on the map.
Important considerations
- Field changes — Modifying a field's type or slug after data has been imported may require re-importing your data. Plan your schema before importing large datasets.
- Plan limits — Field customization is available on all plans.