tut Pro Arcade Pop-Ups
Custom Pop-Ups and the use of Arcade Expressions
(return to the ArcGIS PRO / Cartography Tutorials page)
See also Arcade for Custom Labels
See also:
- View pop-ups (Help)
- Configure pop-ups (Help)
- ArcGIS Arcade Getting Started (Help)
- Pop-ups: text element essentials (Blog)
- Pop-ups: chart element essentials (Blog)
- Pop-ups: tips for adding photos (Blog)
- Pop-ups: use color in text elements (Blog)
- Enhance your pop-ups using Arcade + Living Atlas (Blog)
Pop-Ups can include a simple list of field values as well as Charts, Images and Text elements. Pop-Ups can also be customized using Arcade Expressions.
(Arcade is an Expression language developed by ESRI for use with ArcGIS Pro, ArcGIS Online and spatial data sets. Arcade includes a collection of 'functions' that can be used to modify values, including values from attribute fields. In addition to symbology, labels, etc. Arcade can be used for customizing Pop-Ups.)
To display a pop-up in ArcGIS Pro, click on a feature using the Explore tool (from the Map tab of the ribbon).
By default, ArcGIS Pro (or ArcGIS Online) will display a generic list of all of the fields from the attribute table for the pop-up.
This basic list of fields can be customized by configuring the pop-ups.
In ArcGIS Pro, right-click on a layer in the Contents to open the Configure Pop-Ups pane:
By opening the Fields element (from the Configure Pop-Ups pane) you can specify which fields to be included or excluded from the list:
Close the Fields element by using the back arrow to return to the Configure Pop-Ups pane. Use the Explore tool to view the results in a new pop-up.
Below is the resulting pop-up, displaying only certain fields:
Remove the Fields List Element
You can also remove the Fields list entirely from the pop-up by clicking the X (remove pop-up element) in the fields element in the Configure Pop-Ups pane:
Add a Text Element
Click the Text icon (in the Configure Pop-Ups pane) to add a Text element.
Open the Text element to configure it's content.
Within the Text element you can use the Field drop-down list to insert a value from an attribute field). Field variables are indicated by the use of curly brackets { } in the text element.
Close the Text element by using the back arrow to return to the Configure Pop-Ups pane. Use the Explore tool to view the results in a new pop-up.
Text elements can include carriage returns, multiple fields, custom formatting (bold, italics, etc.). and URL links...
Creating and Adding an Expression
Text elements can also make use of expressions. Pop-up expressions can be created using Arcade, Vbscript, Python, etc. (the examples below use Arcade). Pop-Up expressions are similar to label expressions and can be used to format text and numbers (adding commas, rounding numbers, specifying the number of decimal places, etc.) as well as mathematical operations, etc.
To begin a new expression, click the Expression button at the bottom of the Configure Pop-Ups pane to open the Expression window.
In the Expression window, click New to open the Expression Builder
Below is an example of the Expression Builder using the text function to reformat a population number:
Click OK to save the expression. By default, the first expression is named expression0. You can rename your expression in the Name field if you wish. Renaming your expressions will make it easier to identify them later.
Return to the Text element to include an expression. Expressions will be listed at the bottom of the Fields list and like a Field value will be shown in curly brackets within the text element):
Mathematical Expressions
Expressions can also be used to perform mathematical operations on numbers.
Below is an example of an expression to calculate the difference in population between 2007 and 2000 and then reformat the output value as a text string:
And below is the Text element using the above expression for the custom pop-up - in this example there are 3 expressions, one to reformat the 2000 population number, a second to reformat the 2007 population number and a third to display the difference between 2007 and 2000 population, again reformatted:
See also:
- https://developers.arcgis.com/arcade/function-reference/
- https://www.esri.com/arcgis-blog/products/arcgis-online/mapping/configure-pop-ups-basics/
- https://pro.arcgis.com/en/pro-app/latest/help/mapping/navigation/pop-ups.htm