# Collections list page

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FQWvqVQMU1BP6sPBzycSs%2FFox-BG%20Light%20(14).jpg?alt=media&#x26;token=5133e4bf-55dc-4249-93b8-1cfb99d22088" alt=""><figcaption></figcaption></figure>

The Collections list page displays all the collections you choose to show in one place. You can control which collections appear, adjust the layout, and customize how they look on both desktop and mobile.

## How to access Collections list page template

{% hint style="success" %}
Steps:

1. From the theme editor (**Customize**), select the template selector.
2. In the dropdown menu, select **Collections list** template.
3. Make necessary changes.
4. **Save** the settings.
   {% endhint %}

{% hint style="info" %}
The storefront uses the default handle `/collections`.

Example: `https://yourstore.myshopify.com/collections`
{% endhint %}

## Collection list section

### Section settings

#### Layout

* **Columns:** Choose the number of collection cards to show per row on desktop.
* **Collections per page:** Set how many collections appear before pagination begins.
* **Horizontal gap / Vertical gap:** Adjust the horizontal and vertical spacing between collection cards.

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FZq8CA7jy1Xjn2JFERS2Y%2Fimage.png?alt=media&#x26;token=db8b266f-4ac5-4f22-881b-80157a289ac9" alt=""><figcaption></figcaption></figure>

#### **Mobile layout**

These settings allow you to customize how the collection list appears on mobile devices, including:

* Number of **columns** displayed on mobile.
* **Horizontal** and **vertical** spacing between collection cards.

### Collection list block

#### Collection card

Each block represents a collection card. You can add multiple blocks and reorder them as you like.

* **Aspect ratio:** Sets the shape of the collection image.

{% tabs %}
{% tab title="Use global settings" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FtIll19uJGSmtI4rI032W%2Fimage.png?alt=media&#x26;token=eed7d929-abc5-4a91-bfe1-d0cb4a4d0733" alt=""><figcaption></figcaption></figure>

* Go to **Theme settings > Collection cards and set the aspect ratio** there to use it as a global setting.
  {% endtab %}

{% tab title="Auto" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fjqg9JQBP5EaNenHIJrog%2Fimage.png?alt=media&#x26;token=b2f2e327-3a57-4e56-bc91-ffbe5eae7b47" alt=""><figcaption></figcaption></figure>

* The image ratio adapts to the original size of the uploaded image.
  {% endtab %}

{% tab title="Square (1/1)" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FJRC64hEqI54duKuphH7D%2Fimage.png?alt=media&#x26;token=2430ae60-489c-47dd-8904-4e6e256d8377" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Portrait (4/5)" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FZi2j7WFZ6U3MDllg1x9o%2Fimage.png?alt=media&#x26;token=1542aa89-35e5-46d3-adb0-05e444dfd18b" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Portrait (3/4)" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FNaAjz7eDxjwkdjMsWV3w%2Fimage.png?alt=media&#x26;token=7fb8df68-ab1c-46c1-b84b-726265286400" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Landscape (16/9)" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2F6lq15FULX47j2Nybzxy4%2Fimage.png?alt=media&#x26;token=c0f6e8ee-6a3d-4d92-bc8b-783a780d65ab" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Landscape (4/3)" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2FGOsPM9XJtA3xEWufkafi%2Fimage.png?alt=media&#x26;token=3dad8622-c0e2-410f-b379-d08544a60206" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* **Alignment:** Controls the horizontal alignment of the collection title.

{% tabs %}
{% tab title="Left" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fkmcj0dWV8Ny4uHtBHI5x%2Fimage.png?alt=media&#x26;token=e80f03e1-4a37-414b-93db-f19dd6212df6" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Center" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fs2qRak0zOUvcVkiI8TcP%2Fimage.png?alt=media&#x26;token=78f2b5f8-fefe-4ee7-8143-80ea73f4924d" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Right" %}

<figure><img src="https://1172126658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgoStNEbk9Q25TX38NhdE%2Fuploads%2Fo43Sj49SUCr7Ha8VvUqj%2Fimage.png?alt=media&#x26;token=5b958f88-3a2d-4344-844b-099c92a75617" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* **Show product count:** Toggles whether the number of products in the collection is displayed.

#### Nested dynamic blocks

You can add multiple dynamic blocks within this section.\
Use these blocks to customize the layout further or add additional content types.

{% content-ref url="../theme-blocks" %}
[theme-blocks](https://docs.foxecom.com/pebble-theme/theme-blocks)
{% endcontent-ref %}

## Other sections

The Collections list template supports all theme sections. You can freely add, remove, or rearrange sections—just like any other page.

{% content-ref url="../theme-sections" %}
[theme-sections](https://docs.foxecom.com/pebble-theme/theme-sections)
{% endcontent-ref %}

{% hint style="success" %}

## **Best practices**

* Use high-resolution images for collection thumbnails so the grid looks clean and consistent.
* Order your collection blocks strategically — feature best-selling or seasonal collections first.
* Use the aspect ratio setting to ensure visual consistency across all cards.
  {% endhint %}
