Skip to main content
Variable picker showing available datasource fields

Overview

Data binding connects component properties to dynamic values that resolve at render time. Instead of hardcoding text, images, or URLs, you bind them to variables from datasources, URL parameters, or other data sources configured in your workflow.

Adding a Datasource

Before binding variables, you need to attach a data source to your content:
1

Open the datasource configuration

Click Add a datasource in the editor or access it through the configuration panel when binding a variable.
2

Select the source type

Choose where your data comes from:
Source TypeDescription
DatasourceConnect to a DataHub datasource to access its fields.
WorkflowUse data from the parent workflow — URL parameters, live polling, geolocation, or weather.
CustomDefine a custom variable using transformation formulas.
3

Select the specific datasource

For Datasource type, search and select from your available datasources.For Workflow type, choose the sub-type:
  • Url parameter — A named URL parameter passed at render time.
  • Live polling — Real-time click percentage data.
  • Geolocation — User’s geographic coordinates.
  • Weather — Weather data at the user’s location.
4

Configure and validate

Complete any additional configuration (e.g., parameter name, preview value) and click Validate.

Variable Picker

Once a datasource is attached, you can bind its fields to component properties using the Variables picker:
  1. Click the variable picker icon next to any bindable field in the configuration panel.
  2. The variables panel shows all available fields grouped by datasource.
  3. Select a field to bind it.

Datasource Item Selection

When a datasource returns multiple results, you can choose which item to display:
OptionDescription
Reuse the displayed itemUse the same item (default: item #1) as other bindings from the same datasource.
Display datasource item #NUse a specific result index (e.g., item #2 for the second product).
Use different datasource items to show multiple products from the same datasource in a single content template — for example, a product carousel.

Custom Variables

Custom variables let you define derived values using transformation formulas. After creating a custom variable with a Variable name, you configure the formula in the transformation editor.

Grouping Results

For product datasources, you can optionally group results by a field:
OptionDescription
Aggregated dataAggregate values across the group.
1st product of every groupShow one product per unique group value.
All products of 1st groupShow all products from the first group.
All products of all groupsShow all products regardless of grouping.

Transformations

When a variable is bound, you can apply transformations to format the value — for example, formatting a date, rounding a number, or converting a currency. See the Text component for transformation details.