PlatformConnectivityFlowsLearn

How to Set up a Dynamic Configuration Flow?

Define dynamic selections, pagination rules, and field behaviors that automatically adjust based on user input or real-time data.

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.

  • Select Add Configuration Flow.

  • Name your flow and click Build.

2. Add a Data Mapping Step for Pagination

  • Add a Data Mapping Step.

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

For example, if you’re building a configuration for a file picker widget, you might include:

  • Array variable (files) – this represents the list of files that will appear dynamically through a selection flow.

In an array variable, multiple options can be selected from the widget. If you want to allow only a single option selection, use an object variable instead.

For example, files can be defined as an array to allow multiple file selections, or as an object for single file selection.

  • Open the three-dot menu next to the field and select Options.

  • 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:

  • Enable Selections – Turn on dynamic option fetching.

  • Selection Type – Choose Dynamic.

    • Dynamic selections fetch their options from another flow in real time (for example, a selection flow that retrieves a list of files).

  • Selection Flow – Choose which Selection Flow will power this dynamic data (e.g., a flow named Get Files).

Once selected, the data returned by that flow (like file names or IDs) will automatically appear in the file picker UI inside your widget.

3. Configure Pagination Rules

For dynamic data sets that return large lists (such as files, customers, or records), define pagination logic within the Selections section.

Pagination Settings

  • Pagination Type:

    • Cursor – Uses a pointer to fetch results in chunks.

    • Offset – Uses index-based offsets to load data progressively.

  • Limit: Defines how many records to retrieve per chunk. For example, setting a limit of 50 means results will be fetched in batches of 50.

The pagination ensures smoother UI performance and prevents timeouts when loading large data sets.

4. Link to a Selection Flow

After configuring pagination, select the Selection Flow that will supply your data dynamically. For example:

  • Selection Flow: A flow that defines the selection of your Google files.

When you save this configuration, your widget’s file picker will use the Gcsgetfiles flow to fetch available files dynamically.

Users will then see a file picker UI that allows them to select files based on live data returned by that selection flow.

5. How It Appears in the Widget

Once saved, the configuration flow appears inside your widget as a file picker (or equivalent dynamic component).

The widget automatically:

  • Fetches available options using the connected selection flow.

  • Applies pagination rules (Cursor/Offset + Limit).

  • Reflects the field behaviors you set (hidden, disabled, or dependent visibility).

This creates a seamless dynamic experience, allowing end-users to select real-time data (e.g., files, connectors, records) directly from your Fastn widget.

Use Configuration Flows in Widgets or Other Flows

Once created, configuration flows can be reused:

  • Embed them in Widgets – End-users can interact with your configuration inside the UI.

  • Include in Other Flows – Useful wherever mapping or variable selection is needed.

With this setup, you now have a complete configuration flow that manages variables, supports field-level options, handles pagination, and integrates into widgets or other flows.

PreviousHow to Set up an Activation Flow?NextHow to Set up a Custom Configuration Flow?

Last updated

Was this helpful?