How to Set Up Pagination in Configuration Flows?

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 is where you configure all the variables that will be passed into your target app.

• For example, if you are building a configuration for Zapier, the key entities could include:

i. String id

ii. String connectorID

iii. Object type variable (zaps)

• Open the three-dot menu and configure Options.

In this context, instead of file pickers, you’ll configure pagination fields.

• Under General, you can:

  • Add a Label (this appears in the widget UI).

  • Disable the field.

  • Hide the field in the configuration pop-up.

  • Conditionally hide the field based on another field’s value.

• Under Selections, you can:

  • Enable selections.

  • Mark the field as independent.

  • Define the Selection Type:

    • Static – Predefined list of options.

    • Dynamic – Options fetched at runtime from another flow.

    • Custom – User-defined logic.

These options control how fields appear in your widget and how end-users interact with them.

3. Configure Flow Selections

You can also enable flow-based selections.

• For example, you might let users select from Community Selection Flows or Workspace Selection Flows.

• The data returned by these flows can be paginated to handle large sets of results.

4. Set Pagination Rules

When working with data-heavy flows, configure pagination:

• Pagination Type:

  • Cursor – Uses a pointer to fetch data chunks.

  • Offset – Uses index-based offsets.

• Limit: Defines the maximum number of records retrieved per chunk.

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.