Skip to content
MangoMap Help Centre
Esc
↑↓navigate↵open⌘Jpreview
On this page

How attribute formatting works in MangoMap

The Format tab changes how attribute values show in popups and search, not the stored data. See how renaming, formatting, and hiding differ.

This page explains where attribute formatting applies and where it does not. It also explains the difference between renaming, hiding, and formatting an attribute.

The Format tab in one sentence

The Format tab in the layer settings panel controls how each attribute on a layer displays in popups and search results. The underlying value in your data is never changed — formatting changes only how the value appears.

The three things you can change per attribute

Each row on the Format tab has three independent controls:

  • Alias — the text input on the left. The display label for the attribute. Renaming pop_2024_estimate to Population (2024) changes how popups, search results, and the legend name the field. The underlying field name in your data is unchanged.
  • Format — the chip + pencil in the middle. The display format for the attribute’s value. Changes how the value appears (12345 as 12,345.00, $12,345, 12.3 km, 9 May 2026). The underlying value is unchanged.
  • Visibility — the eye toggle on the right. Whether the attribute appears in the default popup and data search results at all. Hiding an attribute does not delete it.

These three settings are independent. You can rename without changing the format, hide without renaming, or set a format on a hidden attribute (the format takes effect if you turn visibility back on later).

Where formatting takes effect

Each value takes one of two paths: through the Format tab to what people read, or straight from your data to everything that filters, styles, or exports it.

Formatted or raw Data flow: a stored attribute value goes through the Format tab's alias, format and visibility to the default popup, custom popup variables, data search cards, print popups and the legend's field name and gradient or size numbers; filters and queries, styling, map labels, class break and category labels, and data exports use the value as stored. DISPLAY AS STORED Raw value12345.6789 Format tabalias, format, visibility Shown formattedfor example 12,346Default popup and side panelCustom popup variablesData search cardsPrint popupsLegend field nameGradient and size legend ends Used as storedfor example 12345.6789Filters and queriesStyling rulesMap labelsClass and category labelsData exports

Formatted values appear in:

  • The default popup — what users see when they click a feature on the map.
  • Custom popup templates — variables you embed (like {population}) substitute the formatted value, not the raw value. Hiding an attribute doesn’t remove it from a custom template.
  • Data search results — the result cards on the data search panel.
  • Gradient and size legends — the numbers at the ends of a continuous colour gradient and beside a size key.
  • Print and export popup overlays — popups in printed maps or PDFs use the formatted value.
  • The default popup side panel — the inline panel version of the popup.

If you set population to Number → Integer, every place above shows 12,346 instead of 12345.6789.

Where formatting does NOT take effect

A few surfaces always use the raw value:

  • Legend class breaks for quantity-styled layers set to a class count. The legend uses raw numeric values for class boundaries. Setting a Number format on the field doesn’t change those labels.
  • Filters and queries. Filtering by population > 10000 operates on the raw number. Currency formatting doesn’t change the comparison.
  • Styling rules and category labels. Category and quantity styles read the raw value, and category labels in the legend show it as stored. To change a category or class label, edit it in the style’s Customise categories or Customise Class Breaks panel.
  • Map labels. Labels on the map show the value as stored.
  • Exports of the underlying data. Downloading a layer as CSV or GeoJSON exports raw values without formatting.

Formatting changes display only. Analysis, filtering, styling, and export use raw values.

Why some columns have no format options

The Format tab shows alias and visibility controls for every attribute, but the format chip and pencil only appear for columns that have something to format. Text, true/false, ID, and nested-data columns always display as their raw values — there’s no decimals or currency to apply.

The columns that get format options are the ones holding numbers, dates, or measurements.

Auto detect — what the default does

New attributes default to Auto detect, which means MangoMap picks a sensible format based on the value.

Auto detect is fine for most casual use. Set an explicit format (Number, Currency, Measurement, Date & Time) when you want consistent precision, a specific symbol, or a particular date pattern across every feature.

A common confusion

“My class breaks in the legend show 17.34219 instead of 17.” Class-break labels use the raw value, not the Format settings. Round the boundaries in the style’s Customise Class Breaks panel. Those edits live with the style, not the format. Gradient and size-key numbers do follow the Format settings.

“I renamed my field but a category still shows its old text.” The alias renames the field, and the legend uses it wherever it names the field. It doesn’t rename the values in the field. Category and class labels live in the style; edit them in Customise categories or Customise Class Breaks. See How to customise category and class break symbology.

“I set a format but my popup looks unchanged.” Two likely causes. Either the popup is configured as None (which means no popup at all), or the attribute is hidden via the visibility eye. Check both before assuming the format isn’t applying.