What are Arcade expressions in ArcGIS and how do they work?

ArcGIS Arcade is a scripting language that allows you to calculate new data values on-the-fly. Think of it like "calculate field" but without directly editing your database.

Like other expression languages, it can perform mathematical calculations, format text, and evaluate logical statements. Arcade enables energy professionals to transform spatial data dynamically—calculating pipeline capacity utilization, normalizing electricity consumption by service area, or categorizing infrastructure assets—all without modifying the underlying database.

Key Points

- Arcade is unique when compared to other expression and scripting languages because of its inclusion of feature and geometry data types.

- An Arcade expression written in one ArcGIS application can be consistently interpreted in other ArcGIS applications.

- Arcade expressions are useful for calculating new variables without requiring an update to the dataset's schema. They also have the advantage of being dynamic and data-driven, meaning that an expression result will update if the data that is used in the expression changes.

- You can write, share, and execute Arcade expressions in ArcGIS Online, ArcGIS Pro, ArcGIS API for JavaScript, and ArcGIS Runtime. The language is portable, meaning that an expression written in your web map popup will also work in your downstream apps like ArcGIS StoryMaps.

- You can use Arcade to style and label your map, create informative pop-ups, and perform field calculations on your data.

Understanding Arcade Expressions

The Arcade language was designed for use solely within ArcGIS. You cannot use it to build apps. It can only be executed within the context of a designated profile. According to Esri Developer documentation, each profile's context depends on the API or app implementing Arcade.

Esri created its own language because it needed an expression language that met the following requirements: Lightweight and simple - A language with a small number of functions and an easy syntax. Portable - A language that can execute in multiple environments with the same syntax for web, desktop, and mobile apps. Secure - A language that doesn't have security vulnerabilities that open the door to malicious scripts. Geospatial first - A language that makes geospatial functions and capabilities first-class citizens. Developing our own scripting language was the best option because other alternatives, such as Python and JavaScript, couldn't check all of the boxes above either due to language size, or their propensities for security issues.

Arcade will never replace Python because you can't write long scripts with it. Instead, it's more of an expression builder like in Excel. According to GIS Geography, before ArcGIS Arcade existed, you would have had to create a new field and then populate the field with values. The key advantage is convenience: you can calculate values "on the fly" in a web map, query features, change the symbology or labels, and even customize pop-up windows with ArcGIS Arcade.

How It Works

Arcade expressions operate through a structured workflow that transforms data without altering source files:

1. Accessing Data: Profile variables are special global variables that can be used in expressions. For example, $feature references the feature you click on your map to open the pop-up. This variable is used to retrieve specific attributes (fields) for the feature. For example, $feature.name returns the content of the field "name" for the feature.

2. Writing Expressions: In many respects Arcade's syntax is similar to JavaScript, allowing you to declare variables, perform logical operations, take advantage of built-in functions, and write custom functions. According to Esri documentation, it also supports multi-statement expressions, variables, and flow control statements.

3. Executing Within Profiles: Arcade can only be executed within a valid profile. Profiles define rules or specifications for writing a valid expression. This includes defining the valid data inputs (profile variables), supported functions, and return types in addition to the context where they can execute. For example, if your layer has 100,000 features and has a renderer defined with an Arcade expression, that expression must execute 100,000 times to properly render the data. Because of this, the visualization profile prevents you from accessing data from sources outside the original feature since this would severely slow down app performance.

4. Returning Results: Expressions are just a fancy word for the script that you write. The map will treat this like any other data value from your map. Think of it like a new field for the features in your map.

Why It Matters

For energy infrastructure mapping, Arcade expressions solve a critical challenge: the need to analyze and visualize data relationships without constantly modifying geodatabases. With a static dataset, new fields might be created and calculated to reformat dates, categories, and colors. However, this map uses a dynamic dataset, which receives new records every day and which is owned and managed by someone else. Creating new fields isn't an option, but it's also not necessary since you can derive new values from the existing fields with Arcade expressions.

According to Esri, changing data will adapt with no extra calculations or configuration on your part. When your layer has values that change regularly, your symbology/popup/etc. will all update automatically. This dynamic capability is particularly valuable for monitoring real-time energy systems, tracking pipeline flows, or analyzing grid performance where data updates continuously.

Related Terms

• Profile: A context that defines the parameters that are available to the script as global inputs and the output expected from the script.

• Feature: Arcade is unique when compared to other expression and scripting languages because of its inclusion of feature and geometry data types. Features represent geographic entities with both spatial and attribute information.

• Expression Builder: The interface within ArcGIS applications where users write and test Arcade expressions, providing access to profile variables, functions, and testing capabilities.

Frequently Asked Questions

Can I use Arcade expressions across different ArcGIS platforms?

Yes. An expression defining popup content in ArcGIS Pro can be saved to a web map and evaluated with consistent results in a mobile application developed with ArcGIS Maps SDKs for Native Apps, or in a web app, such as ArcGIS Online, or any other app developed with the ArcGIS Maps SDK for JavaScript.

Arcade provides one consistent syntax that can run on desktop, web, and mobile devices.

Do I need to be a programmer to use Arcade?

Not necessarily. According to Esri, you don't need to be a "coder" to be able to create powerful calculations. It has a lot of similarities to Excel for basic functions, but also can be advanced similar to JavaScript for when you want to do more. Simple expressions for normalizing values or performing basic math require minimal coding knowledge.

Where can I use Arcade expressions in my maps?

You can find Arcade most places where you find and use other attributes. For example, symbology, labeling, transparency, popups, and more. Additionally, Arcade can be used to configure bar charts, pie charts, line charts, histograms, and scatter plots.

Last updated: May 12, 2026. For the latest energy news and analysis, visit stakeandpaper.com.