List blocks display collections of items, like contacts, tasks, or projects, in a list format. They include interactive options that let users filter, sort, or create and update items.

Each item in a List block can show details such as titles, descriptions, images, tags, and other fields.

Use case examples

• Product Inventory: Display items in stock with details like product name, SKU, quantity, and location. Users can filter by category or availability to track stock levels.
• Employee Directory: Create a searchable list of employees with details like name, position, department, and contact information.
• Real Estate Listings: Showcase properties with images, location, price, and property details. Users can filter by property type, location, or price range.
• Client List: Organize client information, including industry, location, and project status, to help teams track and access client data.

Configure a List block

Source

The Source panel connects the list block to your data source. Here, you can:

• Connect the list block to your ****data source.
• Set up ****conditional filters to display only the data that meets specific criteria.
• Define sorting rules and set the number of items to display per page.
• Customize the empty state message that appears when no data matches the requirements.

Once you connect to your source data, you can configure Content, Actions, and block Visibility settings.

<aside> ℹ️

Some configuration options depend on the data source. For more details, check the documentation for your specific data source.

</aside>

Content

In the Content tab, customize the List block layout and the data fields in your list block, adjust their display, and add features like search and filters to help users find information quickly.

Sections

The List block includes two display areas:

• The Main Section is the primary display area for each list item. It remains visible even when an item isn’t selected.
• The Secondary Section is an optional area in the list block for showing additional or supporting information that doesn’t need to be visible at first glance.

Item fields

Item Fields lets you connect fields from your data source to each list item, making it easy to display the information you need. You can control what information appears by adding, removing, or rearranging fields such as task names, assignees, or descriptions.

For each field in the Item Fields section of the secondary section, you can customize the following options:

• Type: Defines the display field type that controls how content appears in the block (e.g., text, checkbox, or image).

• Content: Chooses the specific data field from connected data sources to display.

• Label (Optional): Adds context to the field. If left blank, the label will not be visible to users.

  

<aside> ℹ️

Note: Some display field types are compatible only with specific data formats. For example, if a field is set to display images, you cannot map it to text data. Ensure the field type matches your data source field format to avoid display issues.

</aside>

Supported field types