> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/volume-themes/collections/collection-page.md).

# Collection page

Customize Volume collection pages: combine collection banners with product grids, add subcollections via metafields, and create dynamic category navigation.

In the Volume theme, the **Collection banner** is a standalone section, separate from the product grid. This separation allows for greater flexibility when customizing the appearance of your collection pages.

You can combine the **Collection banner** with the **Product grid** in several ways, depending on your layout preferences and content strategy. Here are a few example configurations:

{% columns %}
{% column width="50%" %}
**Collection banner + Product grid**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fr5dP0IfUOlfBNbvN5lW0%2Fimage.png?alt=media&amp;token=73f12145-843b-479e-86c7-b3a830893cf1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
**Subcollection banners + Product grid**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FiKMW0G0ywgo8CMiE9YOK%2Fimage.png?alt=media&amp;token=0aea75d5-b867-4d40-9779-c98d7d3d4955" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}
**Collection banner vertical + Product grid**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2F5nuhfAW4MhphRQA9s0p4%2Fimage.png?alt=media&amp;token=df22ba8b-79dc-41af-aba6-b58b41b250f2" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
**Product grid only**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fc6ucPFy7TClEazFQ06az%2Fimage.png?alt=media&amp;token=4c21bf9d-7c52-471c-ad2c-02206721cad6" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}
**Collection banner with subcollections + Product grid**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FUIwNOCjcAmjSDhjq2XuW%2Fimage.png?alt=media&amp;token=608ebf34-8a1f-418a-ad8a-92b00c162ab3" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}

{% endcolumn %}
{% endcolumns %}

### **Related or subcollections**

Adding related or subcollections to large collections helps users narrow down their search and discover more relevant products faster. This approach improves product discovery and overall user experience, especially when a parent collection contains a wide variety of items. Instead of forcing users to scroll through dozens of products, you can guide them toward more specific categories that match their intent.

Subcollections are displayed as a horizontal slider and can be added in two ways:

* As part of the **Collection banner** section
* As a standalone **Subcollection banners** section (if you prefer not to display a collection image)

**To make this setup dynamic**—so that each collection displays its own relevant subcollections—you’ll need to create and connect a metafield.

{% stepper %}
{% step %}

### **Step 1: Create a metafield for collections**

1. Go to **Settings** → **Metafields and metaobjects** → **Collections**
2. Click **Add definition** and fill in the fields:

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2Fwab47JY3GfmrANXYr4Z6%2Fimage.png?alt=media&amp;token=bc16b1d0-d2aa-4963-8ada-e36d080efc32" alt=""><figcaption></figcaption></figure>

* **Name**: Subcollections
* **Namespace and key**: custom.subcollections
* **Type**: Collection
* Enable **List of collections**

3. Click **Save**
   {% endstep %}

{% step %}

### **Step 2: Bulk assign subcollections**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FXLfoPuMxOsbLV2fHfqra%2Fbulk-edit.gif?alt=media&amp;token=90776ef8-9773-4aff-92c4-688d07f67be2" alt=""><figcaption></figcaption></figure>

1. Go to **Products** → **Collections**
2. Select all collections and click **Bulk edit**
3. Open **Columns**, add **Metafields → Subcollections**, and hide any unnecessary fields
4. Assign subcollections to each collection as needed
   {% endstep %}

{% step %}

### **Step 3: Connect dynamic sources**

<figure><img src="https://846450420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJZYrhya1ZIeTZS4wpBJB%2Fuploads%2FXrdnhhGgVKicHUoEfcGI%2Fsubcollections.gif?alt=media&amp;token=61e6f032-8461-4d81-83d2-85129aa8d854" alt=""><figcaption></figcaption></figure>

1. Open the **Collection banner** or **Subcollection banners** section in the theme editor
2. Click the **dynamic source icon** next to the **Collections** field
3. Choose **Template → Collection → Subcollections**
4. Save your changes
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/volume-themes/collections/collection-page.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
