Metadata List Block

Article Topics: Blocks, Metadata, Design

Overview

The Metadata List Block allows you to display a list of metadata values you've configured in your CMS such as categories, tags, and any other custom created metadata types. This makes it the ideal block for creating category pages.

Metadata List Block Settings

List Settings

In the Data Source section, you can select the Metadata Type to display.

Once a Metadata Type has been selected, you can choose to filter by specific values within, including:

• Specific Metadata ID(s) - A Comma separated list of metadata ids. An example:

  • Data Source: Categories

  • Filter: ID/IDs

  • Specific ID/IDs: 134,578,1927

  • Outcome: This will load Category ID 134, 578, 1927 in your list

• Specific Set ID(s) - A Comma separated list of set ids. An example:

  • Data Source: Categories

  • Filter: Set ID/IDs

  • Specific ID/IDs: 2,45

  • Outcome: This will load any Categories associated with Set ID 2 or 45

• Values in the Page Path - Used for dynamically displaying content based on the value in the URL.

In addition to filtering by IDs, you can filter Metadata by Channels. Content Sets are published to Channels, and Content Sets can have Metadata associated with them, so selecting the Channel will limit which Metadata are displayed.

See the Channels article to learn more.

The order of the content can be determined using the Display Order field, whether that is alphabetically, recently published, most liked, and more.

Filtering by Data Source Attributes lets you filter based on attributes associated with the selected metadata, helping you show only metadata values matching a specific attribute.

Please Note: If the Data Source is a Metadata Type that does not contain any properties, you will not see any new fields listed under "Filter by Data Source Attributes"

In the Filter by Set Metadata section, you can further filter the content based on specific metadata associated with the set list.

Design

The header for the block can be set using the Header Text field.

Use the Click Destination field to determine where visitors or members are sent after clicking a Metadata in the list. You can link to a static URL, CMS Page, or signup form.

Pro Tip: Set the destination page to one that includes a block configured to use the Metadata ID or slug passed through the page path.

Results List

Customize the look and behavior of the metadata thumbnails with the following options:

• Set the maximum number of metadata to display on your page.

  • Note: When pagination is enabled, a page list will be displayed under the metadata list.

• Choose the thumbnail size.

• Add custom CSS class to the thumbnails.

• Determine a starting index.

The result list can be further customized using Pagination if you want to limit the number of items to display.

If optimizing your site for mobile, the Thumbnails Per Row settings provide a way to set how many thumbnails appear per row, depending on the size of the screen.

All blocks contain Block Design and Block Content settings. These control how the block fits into the page itself. This may include:

• Adding background colors, padding, classes, or IDs to the block

• Changing the width of the block, and how it fits into your page

More information about Block Design and Block Content settings can be found here.

Related Articles

Block TypesMetadataSet View BlockSet List Block