# Metadata List Block *Article Topics:* [*Blocks*](https://docs.toomuchmedia.com/getting-started/common-topics/blocks)*,* [*Metadata*](https://docs.toomuchmedia.com/getting-started/common-topics/metadata)*,* [*Design*](https://docs.toomuchmedia.com/getting-started/common-topics/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. In addition to these settings is the **Channel URL Filter.** When this is enabled, the list of metadata that appears in the Metadata List will be filtered to only display metadata for sets published to the Channel that is defined in the URL. See the [Channels](https://docs.toomuchmedia.com/content-management/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. {% hint style="info" %} 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**" {% endhint %} 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. {% hint style="success" %} **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. {% endhint %} #### 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](https://docs.toomuchmedia.com/content-management/member-areas-and-tours/themes/block-types/..#common-block-settings). ## Related Articles {% content-ref url="" %} [](https://docs.toomuchmedia.com/content-management/member-areas-and-tours/themes/block-types) {% endcontent-ref %} {% content-ref url="../../../../getting-started/common-topics/metadata" %} [metadata](https://docs.toomuchmedia.com/getting-started/common-topics/metadata) {% endcontent-ref %} {% content-ref url="set-view-block" %} [set-view-block](https://docs.toomuchmedia.com/content-management/member-areas-and-tours/themes/block-types/set-view-block) {% endcontent-ref %} {% content-ref url="set-list-block" %} [set-list-block](https://docs.toomuchmedia.com/content-management/member-areas-and-tours/themes/block-types/set-list-block) {% endcontent-ref %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toomuchmedia.com/content-management/member-areas-and-tours/themes/block-types/metadata-list-block.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.