Skip to main content

How to use the Layout Repeater

Create consistent, repeatable content layouts inside any WYSIWYG editor using static or dynamic data.

S
Written by Support
Updated today

The Layout Repeater is a design tool available inside any WYSIWYG editor across Buildfire plugins. It allows you to insert prebuilt layout blocks and repeat them efficiently, helping you maintain consistent design while saving time. Layouts can be populated manually or dynamically using expressions and external data sources such as Google Sheets or APIs.


How to use the Layout Repeater

  1. Log in, go to Builder in the left navigation

  2. Open any plugin that includes a WYSIWYG editor

    • This includes plugins such as folders, YouTube, or any feature with a text editor

  3. Click inside the WYSIWYG editor and click Insert

  4. Click Insert Layout

    • Select one of the available preset layouts

    • Click Insert to add the layout block

  5. Edit the layout content

    • Update the title, caption, body text, image, and button text

    • Click the button’s edit or link icon to connect it to app content, web links, push notifications, contact actions, or other features

  6. Add additional layout blocks

    • Click InsertInsert Layout again

    • Insert another layout to stack multiple repeated sections

  7. Link layout elements to dynamic data (optional)

    • Click InsertInsert Layout, then click Link Data

    • Select a layout element (title, caption, image, or button)

    • Click the expression editor

  8. Use expressions for dynamic content

    • Insert user data such as display name, email, or last login

    • Add dates, math expressions, or HTML

    • Click Evaluate to preview the result

    • Click Use Expression to apply it

  9. Connect external data sources (optional)

    • Go to SettingsIntegrationsData Sources

    • Add a Google Sheet or Web API data source

    • Enter required IDs, keys, and configuration details

    • Test the connection to confirm data is available

  10. Bind layout content to a data source

    • Return to the WYSIWYG editor

    • Insert a layout and click Link Data

    • Select a connected data source and field

    • Evaluate and apply the expression

  11. Enable layout repetition

    • Turn on the Repeat Layout option

    • The layout will automatically repeat for each data record

  12. Preview the repeated layout

    • Confirm repeated items display correctly in the preview panel

    • Adjust spacing, content, or expressions as needed


Pro tips

  • Use layout repeaters to create lists, cards, or content feeds without manual duplication

  • Expressions are useful for personalization such as greetings or dates

  • External data sources allow layouts to update automatically without editing the app

  • Test dynamic layouts carefully to ensure data formatting is correct

Did this answer your question?