Continue in the app
Be The First To Get Support Updates
Want to know about the latest technical content and software updates?

How To: Create multiline labels in ArcGIS Online Map Viewer


In ArcGIS Online Map Viewer, multiline labels can be created using the Arcade custom expression builder. In this article's example, the California_Office_Branches layer contains information on the branches in California, as shown in the attribute table below.

ArcGIS Online Map Viewer Classic does not support multiline labels.
The attribute table containing the Office_Size  and Contact_Number fields of the California_Office_Branches layer.

The expression below is used to create a label displaying the Office_Size and Contact_Number field values on two separate lines for each office.

The TextFormatting.NewLine constant inserts a line break between the two fields.


  1. In ArcGIS Online, open the layer in Map Viewer and enable labeling. For instructions, refer to Steps 1 through 6 of this help document: ArcGIS Online: Apply labels.
  2. In the Label features pane, click Add label class.
The Label features pane
  1. Under Label field, click the Use expression Use expression icon. icon.
The Label features with the Use expression icon displayed.
  1. In the editor window, in the Expression box, highlight the content and press Delete to clear the box.
  2. Build the expression.
    1. Click Globals, and click $feature["<field 1>"]. In this example, it is $feature["Office_Size"].
    2. Type +.
    3. Click Constants, and click TextFormatting.NewLine to add a line break.
    4. Type +.
    5. Click Globals, and click $feature["<field 2>"]. In this example, it is $feature["Contact_Number"].
    6. Click Test to verify the expression, and click OK.
Repeat Steps 5(b), (c), (d), and (e) for every added field, replacing $feature["<field 2>"] with a preferred field before clicking Test.
The editor window contains the expression to run and display the Test option to verify the expression.

The map below displays the office branches in California labeled with their respective office sizes and contact numbers on separate lines.

Map of the office branches in California labeled with office sizes and contact numbers on two separate lines.

Related Information

Last Published: 6/10/2021

Article ID: 000025694