If you connect a text element to something like Customer Data, you might wonder how the Builder determines which customer’s data to display, since it could be:
The customer currently selected in the Customer List
The one linked to an order selected earlier from the Orders List
Or the customer in the active cart
Dynamic data in Builder is context-aware, meaning it automatically determines what to display based on where it is placed within the flow. When you connect an element to dynamic data, Builder evaluates the context of the surrounding container to decide which specific data record the element should reference. Most commonly, this parent container falls into one of two groups:
Elements such as the Orders List, Customer List, Product List, and Product Grid are considered repeater-based elements, as they are designed to display a collection of items.
When you add a repeater-based element to the canvas, Builder automatically adjusts the number of tiles or rows based on the number of items available in the connected data source. For example, if your company has five products saved, adding a Product List to your canvas will immediately generate five product tiles, each corresponding to one of those products. You only need to design the first tile, and the rest will automatically follow the same structure and styling.
Since each tile in a repeater-based element represents a single item from a list, the dynamic text within that tile automatically reflects the data for that specific item..
Examples:
In a Customer List, binding a text element to Customer Data → Customers Email will display each customer’s email on the corresponding tile linked to that customer in the database.
In an Orders List, connecting a text element to Customer Data → Customer Email will display the email address of the customer associated with each order.
In a Product Grid, binding a text element to Product Data → Product Price ensures each tile shows the correct price for the corresponding product.
Sections are container elements used when you want to display data for a single item selected from a list or grid; For example, an order selected from an Orders List, or a customer chosen in a customer list.
Currently, We offer three types of Section elements:
Product Section
Customer Section
Order Section
When a user selects an item from a repeater-based element, such as a Product List, Customer List, or Orders List, the corresponding section updates to reflect that selection. Any dynamic data placed inside the section will pull values from the selected item.
Examples:
A cashier selects an order from the Orders List. In the Order Section, you can show the order date, total amount, list of products, and the name of the customer who placed it. This section becomes a focused view of just the selected order.
A user taps on a customer in the Customer List. Inside the Customer Section, you can display that customer’s name, phone number, email, and total number of orders. As the user selects different customers, the section updates in real time.
