You are here:
Global Variables Flow Approval Processes Resource
A system-provided variable hold information that can be referenced throughout the flow approval process. For example, it can contain information about the Salesforce org, running user, or triggering record.
Required Editions
| View supported editions for Flow Approval Processes. |
| Global Variable API NAME | LABEL | Description |
|---|---|---|
$Api
|
API | The Session ID’s SOAP API endpoints. These merge fields are available.
|
$Label
|
Custom Label | A label in a custom label file in your Salesforce org. This global variable appears only if your org has custom labels. The returned value depends on the language setting of the contextual user. The value returned is one of the following, in order of precedence:
|
$Orchestration |
Current Orchestration Run | The orchestration instance associated with the parent approval process while it’s running. |
$Organization
|
Running Org | The Salesforce org where the flow is running. With this variable, you can access information like the organization’s name or address. |
$Permission
|
Running User’s Permission | The custom permission access of the user running the flow. |
$Profile
|
Running User Profile | The profile of the user running the flow approval process. With this variable, you can access information like the license type or name.
|
$Record
|
Triggering Object, for example, Triggering Account | The record that triggered the flow approval process. Available only in record-triggered flow approval processes. In a record-triggered flow approval
process, the orchestration run associated with the parent approval submission makes
a copy of the triggering record when it starts. If a flow called by a step within
the flow approval process that the orchestration run is based on makes a field
update on the triggering record, it’s not reflected in the You can
reference |
$Record__Prior
|
Prior Values of Triggering Object, for example, Prior Values of Triggering Account | The triggering record before a change triggered the flow approval process. Available only in record-triggered flow approval processes that are configured to run when a record is updated or when a record is created or updated. The
When the flow approval process is triggered by a newly created
record, all |
$Setup
|
Custom Hierarchy Settings | Your custom settings of type Hierarchical custom settings allow values at these levels. Salesforce determines the correct value for this custom setting field based on the running user’s current context.
|
$System
|
System | The system’s OriginDateTime ($System.OriginDateTime), which
represents the literal value of 1900-01-01 00:00:00. Use
this merge field to perform date/time offset calculations. |
$User
|
Running User | The user who’s running the orchestration run associated with a parent approval submission. Most of the time, the running user is the automated process user. When the running user is the automated process user, $User doesn’t provide useful information.
|
$UserRole
|
Running User Role | The role of the user who’s running the orchestration run associated with a parent approval submission. For example, reference the role name or ID. |
Global Variable Considerations for Flow Approval Processes
- In a record-triggered flow approval process, the
$Recordglobal variable doesn’t contain the triggering record’s values for fields whose values are derived from other records. Examples of derived fields includeContact.NameandUser.MediumPhotoUrl. - Multi-select picklist, time, and location global variables are available only in formulas.
- If a field in the database has no value, the corresponding merge field returns a blank
value. For example, if no value is set for your org’s Country field,
{!$Organization.Country}returns no value.

