You are here:
Global Variables Flow Approval Processes Resource
System-provided variables store information that you can reference throughout a 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. Salesforce returns a value based on this order of precedence:
|
$Orchestration |
Current Orchestration Run | References 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 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 If the triggering record is created and updated in the
same transaction, |
$Setup
|
Custom Hierarchy Settings | Your custom settings of type With hierarchy custom settings, you can define 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.
For example, a user has the preference and permissions to see the
Lightning Experience look and feel. However, they're using a browser, such as an
older version of Internet Explorer, that doesn't support that look and feel. In this
example,
|
$UserRole
|
Running User Role | References the role of the user who’s running the orchestration run that’s 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 that derive their values 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 your org's Country field has no value,
{!$Organization.Country}returns no value.
