Skip to main content

Edit Label Text

Labels include a Text field for custom callouts

Written by Holly Conrad Smith

Add fixed or dynamic text to labels using the Content and Subtitle settings.

Content

The label content is the text, properties, or image that is displayed.

For text and outline labels, you can type text into the content box, or select properties to display.

Fixed Text

Type any value into the text box in the properties palette.

This value is displayed in the label on the map.

Dynamic Text

Label content can also display dynamic property values, like areas, lengths, usages, and more!

To reference a property in the label content, click the Pencil icon.

The Text editor appears.

  • Search for properties in the dropdown.

    • Select one or many.

    • The order of the property selection is the order which they are added to the Template box.

  • Edit the text in the "Template" box.

    • For instance, change the Label for GBA to Gross Building Area.

    • Do not edit anything {{within the brackets}} to ensure correct calculations!

  • Review the preview to see what will appear in the marker on the map

  • Click "save marker text" to apply.

The label text reflects the template text.

Anything {{within brackets}} displays the current value of that property.

As the data changes, the property values update dynamically.

Advanced text formatting

Label property text templates use Python's format specification mini-language. The format() function takes a format spec string and a value (which can include a calculation).

Edit the text within the {{ }} in the Template (advanced) text box to adjust the text formatting.

TYPE

Change the type to change the numeric display

d

Integer, decimals truncated

198,196

f

Float, 6 decimal places

198196.476800

.2f

Float, fixed decimal places

198,196.48

e

Scientific notation

1.982e+05

2e

Scientific, fixed decimal places

1.98e+05

%

Percentage (value × 100)

45.300000%

.1%

Percentage, fixed decimal places

45.3%

GROUPING (thousands separator)

,

1,234,567

_

1_234_567

null

1234567

EXAMPLES

The spec string structure is: [grouping][.precision][type]

  • format(',d', value) → 198,196

  • format(',.2f', value) → 198,196.48

  • format('.1%', value) → 45.3%

  • format(',.0f', value) → 198,196

  • format('.2e', value) → 1.98e+05

You can also include calculations

{{format('spec', properties.someValue * multiplier)}}

This is commonly used in Giraffe to convert metric to imperial.

You could also use it to convert to larger area measures like hectares or acres.

  • {{format(',d',properties.grossArea*10.763910416708914)}}ft² -> 198,196ft²

  • {{format(',d',properties.perimeter * 3.280839895013)}}ft -> 1796ft

Subtitles

Add a smaller scale line of text next to your marker.

Subtitle text can only be fixed.

(Not available on plain text kind)

Did this answer your question?