Skip to main content

Use Custom data tables in SmartBlocks

After creating your Custom data table and importing data into it, you can use it in a SmartBlock.

Updated over a week ago

Before you start

Things you need to know:


Add data to a SmartBlock

  1. On the Edit SmartBlock page, expand the Settings () drop-down menu at the top and select Table Lookup.

  2. Select Add Lookup + to open the Custom data table Lookup menu.

  3. Expand the CUSTOM DATA TABLE drop-down menu and select your Custom data table.

  4. Expand the Lookup Field Type drop-down menu and choose from:

    • Merge Parameter

    • Person

    • Product

    The Lookup field type is the type of data collection that you’re pulling the lookup field value from to check against your Custom data table.

  5. For Lookup Field, enter the Lookup field for the data you want to use.
    Learn more in the section Select a lookup field.

    For Person or Product fields enter the prefixes extend. or ex. before the field name:

    • Merge Parameter: Enter fieldname

    • Person: Enter extend.fieldname

    • Product: Enter ex.fieldname

  6. Select ADD.

After adding the Custom data table to the SmartBlock you can reference it using Jinja in either the SmartBlock editor or the SmartBlock’s Layout.

Add data using the SmartBlock editor

  1. In the SmartBlock editor, select the Design tab.

  2. Expand the drop-down menu for the element you want to edit.
    The element must be compatible with Jinja. For example, Image Headline.

  3. For the element’s text field enter the Jinja code to identify the data you want to use.


    Use the following formats for a Person field, Merge field, or Product field:

    • Person field or Merge field
      {{ table.[table_id].[table_field_id] }}

    • Product field
      {{ product.table.[table_id].[table_field_id] }}

  4. Select SAVE.

Add data using the SmartBlock Layout

  1. In the SmartBlock editor select the Edit layout (</>) icon.

  2. Find the area of the layout you want the table’s data to display.

  3. Enter enter the Jinja code to identify the data you want to use into the layout using the following formats for a Person field, Merge field, or Product field:

    • Person field or Merge field
      {{ table.[table_id].[table_field_id] }}

    • Product field
      {{ product.table.[table_id].[table_field_id] }}

  4. Select VALIDATE OUTPUT and SAVE.

The data is now available in the selected layout for use in your SmartBlocks.

Did this answer your question?