# How to create a Categories page

*Article Topics:* [*Blocks*](/getting-started/common-topics/blocks.md)*,* [*Metadata*](/getting-started/common-topics/metadata.md)*,* [*Pages*](/getting-started/common-topics/pages.md)

This article will detail how to create a categories page, allowing your members to browse content based on metadata, in this case, specifically the category metadata.

You will use a combination of the [Metadata List Block ](/content-management/member-areas-and-tours/themes/block-types/metadata-list-block.md)and a [Set List Block](/content-management/member-areas-and-tours/themes/block-types/set-list-block.md). The Metadata List Block will be used to display a list of categories, and the Set List Block will be used to display content sets with the related metadata.

## Configure Metadata in the CMS

Before building the page, ensure that your metadata is set up correctly.

1. Navigate to the **Metadata** section of the CMS.
2. Select the **Categories** Metadata Type on the left-hand side. 
3. Add individual Categories, since these will become the clickable categories on your page.

You can learn more about Metadata in the [Metadata](/content-management/metadata.md) article.

## Create a Category Gallery Page

This will be the page that displays content filtered by the category that was selected by a member.

1. Create a new page and give it a descriptive name like **Category Gallery.**
2. Set the **Page Path** to something like **/category/:id** or **/category/:slug** to indicate to members where they are. 

This path will allow the Metadata List Block to pass the unique metadata ID through the URL.

## Add a Metadata List Block to a Page

Next, create or edit a page where you would want to display the list of categories. 

1. Add a **Metadata List Block** to your page.
2. In the **List Settings** tab, set the **Data Source** to **Category.**
3. Select the **Channel** containing Sets with the relevant **Categories**.
4. In the **Design** tab, set the **Click Destination** to the **Category Gallery** page created earlier.

## Add a Set List Block to the Gallery Page

1. Add a **Set List Block** to the **Category Gallery** page.
2. In the **List Settings** Tab, select the **Channel** with the relevant content.
3. Under the **Filter by Set Metadata** section, set the Category field to "Dynamic:  Use Query String parameters (category=value)"

This ensures that the **Set List Block** only shows content sets that match the clicked **category**. 

With the Metadata List Block and the Set List Blocks working together, you can create a dynamic Categories page that provides a smooth navigation experience for your visitors. 

## Related Articles

{% content-ref url="/pages/1uzBuWsDBEUtbOlMpGA2" %}
[Metadata](/content-management/metadata.md)
{% endcontent-ref %}

{% content-ref url="/pages/urnU6zhpVkCNfXHocNBW" %}
[Set List Block](/content-management/member-areas-and-tours/themes/block-types/set-list-block.md)
{% endcontent-ref %}

{% content-ref url="/pages/D4owpMjJKGawOfQaFVqF" %}
[Metadata List Block](/content-management/member-areas-and-tours/themes/block-types/metadata-list-block.md)
{% endcontent-ref %}

{% content-ref url="/pages/GnJOwUcaAslymas8XykU" %}
[Pages](/content-management/member-areas-and-tours/themes/pages.md)
{% endcontent-ref %}

{% content-ref url="/pages/mNu7NSiyXa72s13bgcBr" %}
[Dynamic Pages](/content-management/member-areas-and-tours/customizing-your-theme/dynamic-pages.md)
{% 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/customizing-your-theme/how-to-create-a-categories-page.md?ask=<question>
```

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.