Dynamic Content

The Dynamic Content component renders UI elements based on JSON. This enables programmatic control over what content appears in an app, making it ideal for displaying AI-generated responses, API results, or data-driven layouts.

Adding a Dynamic Content component

1. In the Layout Editor, select the screen where the component should appear.

2. Click the plus symbol in the Components panel.

3. Select Dynamic Content from the Custom section.

4. Configure the Descriptions field to point to a column containing JSON, or enter JSON manually.

Configuring Dynamic Content

The Descriptions field accepts a column containing JSON that defines which components to render. The JSON can be a single component object or an array of multiple components.

Single component example:

Multiple components example:

Visibility Conditions control when the component appears. Add conditions based on column values or user properties to show the component only when specific criteria are met.

Use the Notes field to add internal documentation about the component's purpose or the expected JSON format.

Component types

The Dynamic Content component supports seven element types, each with specific properties and requirements.

text

text displays plain text with optional styling. The JSON has the following requirements:

1. kind must be text.

2. text content should be a string.

3. Use style to change the text appearance. Valid options are:

• large

• regular

• small

• footnote

• metaText

• headlineXSmall

• headlineSmall

• headlineMedium

• headlineLarge

• headlineXLarge

rich-text displays formatted text using HTML or Markdown. The JSON has the following requirements:

1. kind must be rich-text.

2. text should contain your HTML or Markdown content.

image

image displays an image from a URL. The JSON has the following requirements:

1. kind must be image.

2. image should be the image URL.

There are several optional parameters you can add. style, size (S, M, or Full), aspectRatio, and imageFill can all be specified as a string. fullWidthOnMobile and zoomable can be specified as a true/false boolean value.

hint

hint displays a callout message. The JSON has the following requirements:

1. kind must be hint.

2. text should be a string containing the message content.

3. Optionally, use mood to set the tone style of the hint (Default, neutral, success, warning, or danger).

big-numbers

big-numbers displays prominent numeric values. The JSON has the following requirements:

1. kind must be big-numbers.

2. items should be an array of objects. Each item can include more detail as a string:

   • name: the label for the value

   • value: the displayed number or value

   • description: additional context

3. Optionally, use title to add a section heading.

list

list displays a list of items. The JSON has the following requirements:

1. kind must be list.

2. items should be an array of objects. Each item can include more detail as a string:

   • title: the item title

   • subtitle: the item subtitle

   • image: an image URL

   • emphasis: highlighted text

3. Optionally, use title to add a heading to the list.

table

table displays tabular data as rows of key-value records. The JSON has the following requirements:

1. kind must be table.

2. items should be an array of objects where keys are column names and values are strings or numbers.

3. Optionally, use title to add a table heading.