You are here:
Create and Manage Value Maps
Create, update, and delete value maps from the Global Flow Resources page to reuse mapping logic across flows.
Required Editions
| View supported editions. |
| This feature requires the MuleSoft for Flow: Integration add-on. Exceptions are segment-triggered flows, activation-triggered flows, and broadcast flows, which don't require the MuleSoft for Flow: Integration add-on. Professional Edition requires the API access add-on. To purchase an add-on, contact your Salesforce account executive. |
| MuleSoft for Flow: Integration features used with Agentforce require the Foundations or Agentforce 1 edition. To purchase these editions, contact your Salesforce account executive. |
Use the centralized Global Flow Resources page to manage value maps outside Flow Builder. All flows that reference a value map automatically reflect its updates. For limitations and considerations of value maps, see MuleSoft for Flow: Integration Limits & Considerations.
- Open the Automation app, and select Global Flow Resources.
- Click New, and select Value Map.
- Enter a label, API name, and an optional description. Then select a source data type and target data type.
-
Add at least one source-to-target mapping entry.
Provide a unique source value within the value map.
-
Under Set Default Behavior, select how to handle unmapped source
values.
- Fail the flow
- Pass through as an unmapped value
- Define a default value
- Save the value map.
-
Open the value map from the list, and update mappings in the details view.
All dependent flows that reference this value map use the updated entry values.
- Open the Flows using Value Map related view, and inspect referenced flows.
-
Open the value map, and click Delete.
You can delete a value map only when no flows reference it.
Use a Value Map in Transform
Apply a value map in Transform to translate input values before writing them to a target field.
Use this pattern when source and target systems use different value sets for the same business field.
- Open your flow in Flow Builder and select a connector action that uses field mapping in Transform.
- In field mapping, locate the target field that requires translated values.
- Switch the mapping input mode to Value Mapping.
- Select the source input that contains the value to translate.
- Select an existing value map, or create one if needed.
- Confirm the mapped output for the target field, and save your flow.
-
Debug the flow and test mapped and unmapped source values.
The flow returns values based on your value map entries and selected default behavior.
If you update value map entries later, dependent flows that reference this value map use the latest entry values without requiring flow metadata changes.

