PlatformConnectivityFlowsLearn

How to Set up a Mapping Configuration Flow?

Learn how to configure a mapping selection in your configuration flow, link source and destination flows, and control editable fields for your final widget setup.

Configuration flows in Fastn allow you to define variables, map values, and build reusable configurations that can be used in widgets or other flows.

1. Create a Configuration Flow

  • Go to the Widgets section in Fastn.

  • Click the arrow next to the Add Widget button (top-right corner).

  • Select Add Configuration Flow.

  • Enter a name for your configuration flow and click Build.

This creates a configuration flow where you can add steps such as data mapping and field selectors.

2. Add a Data Mapping Step

  • Inside the flow, add a Data Mapping Step.

The Data Mapper defines the variables and parameters that will be dynamically passed into your target app or flow.

  • Click the three dots on this step to access options:

    • Advanced Action

    • Add Parent Key

    • Set Default Value

    • Options

The Options setting lets you configure fields that support labels, selectors, and values.

  • Configure the following sections:

General Section

Define how this field behaves and appears in the configuration pop-up:

  • Label – Sets the display name in the widget UI.

  • Disable this field – Prevents user edits.

  • Mark as new ID field – Assigns a unique identifier for the configuration.

  • Hide this field in configuration pop-up – Keeps advanced fields hidden from the user.

  • Conditionally hide this field – Hide based on the value of another field (useful for dependent selections).

Selections Section

This is where you make the configuration dynamic:

3. Setting Up the Mapping Configuration

In the Selections section, select Mapping from the list as your Selection Type.

This enables you to map data between flows by linking a Source Flow and a Destination Flow.

  • Enable Selection – Toggles whether selection is active for this field.

  • Set this field as independent? – Determines if the field functions independently from other mappings.

  • Selection Type – Should be set to Mapping for this configuration.

Mapping

  • Select Source Flow – Choose the flow you want to pull data from. You can select from:

    • Community Selection Flows – Predefined public flows.

    • Workspace Selection Flows – Your workspace-specific flows.

  • Select Destination Flow – Choose the target flow where the mapping will apply. The same community and workspace flow lists will appear for destination selection.

Editable Options

  • Keys are Editable – Allows editing of field keys from the source flow during mapping.

  • Add Fields – Enables adding new fields to the destination flow during mapping.

Once configured, click Save.

5. Map Output to Widget Fields

After you’ve selected your source and destination flows, the mapped values will automatically become available in your widget fields.

Depending on your setup, editable keys and added fields will appear directly in the widget section, allowing further customization.

PreviousHow to Set up a Custom Configuration Flow?NextHow to Set up Field-Level Validation in Configuration Flows?

Last updated

Was this helpful?