HOW TO

Create multiline labels with concatenated text using Arcade in ArcGIS Pro

Last Published: July 21, 2023

Summary

In ArcGIS Pro, multiline labels with concatenated text (string) can be created using the Arcade label expression. In this article, the Schools layer contains information on schools in Florida, such as city, ZIP Code, and type of school, as shown in the attribute table below.

The attribute table containing the City, ZIP Code, and Type fields of the Schools layer.

The workflow provided describes how to create multiline labels displaying the CITY, ZIPCODE, and TYPE field values using the TextFormatting.NewLine constant and concatenate the text preceding each field value.

Note:
The TextFormatting.NewLine constant inserts a line break between the labels.

Procedure

  1. In an ArcGIS Pro project, add the layer, and create the label expression. For instructions, refer to Steps 1 through 4 in ArcGIS Pro: Writing a label expression, and select Arcade for Language.
  2. Build the expression in the Expression box.
    1. In the Expression box, highlight the content, and press Delete to clear the box.
    2. Type 'City:' + as the preceding text before the CITY field values.
    3. Under Fields, double-click the CITY field to add to the expression.
    4. Type + TextFormatting.NewLine to add a line break.
    5. Type + 'ZIP Code:' +.
    6. Under Fields, double-click the ZIPCODE field.
    7. Type + TextFormatting.NewLine to add another line break.
    8. Type + 'Type:' +.
    9. Under Fields, double-click the TYPE field.
    10. Click the Verify button to validate the expression. Click Apply to run the script.
The expressions are written to create multiline labels with concatenated text preceding each field value.

The code block below shows the full expression used.

'City:' + $feature.CITY + TextFormatting.NewLine + 'ZIP Code:' + $feature.ZIPCODE + TextFormatting.NewLine + 'Type:'+$feature.TYPE

The map displays the distribution of schools in Florida, labeled with their respective city name, ZIP Code, and school type on separate lines.

The map displays the distribution of schools in Florida labeled with their respective city name, ZIP Code, and school type.

Article ID: 000026373

Software:
  • ArcGIS Pro 2 8 x
  • ArcGIS Pro 2 7 x
  • ArcGIS Pro 2 x

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options