> For the complete documentation index, see [llms.txt](https://vshop.gitbook.io/vshop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vshop.gitbook.io/vshop/theme-sections/collection-list.md).

# Collection List

To customize the Collection List in our theme please follow the steps:

{% hint style="success" %}
Steps

1. In the theme editor (**Customize**), click **Add section**
2. Locate **Collection List**
3. **Save**
   {% endhint %}

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FSObON8tiZoButGl30qbt%2Fimage.png?alt=media&amp;token=85f2584d-f2c6-4360-8d2c-b8d14edb137e" alt=""><figcaption></figcaption></figure>

## Section Settings

### **Section Header**

* **Show header** – Toggle to display the section header.
* **Heading** – Add a main title (e.g., *Shop by Category*).
* **Description** – Optional supporting text.
* **Text alignment** – Align content (*Left*, *Center*, or *Right*).
* **Show button** – Toggle ON to display a call-to-action button.
* **Text button** – Button label (e.g., *View all collections*).
* **Link button** – URL or internal link for the button.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FIAslMtenNpS5hxKyLRnh%2Fimage.png?alt=media&amp;token=89e1365d-de20-4b9c-bb56-020cf3943fda" alt=""><figcaption></figcaption></figure>

***

### **General**

* **Layout** – Choose section layout (*Default*).
* **Color scheme** – Apply a color theme for the background and text.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FM5AtJE04erRCF03xyiXm%2Fimage.png?alt=media&amp;token=c735a925-e680-4cc5-80b0-f42809d24968" alt=""><figcaption></figcaption></figure>

***

### **Collection Settings**

* **Collection type** – Choose between *Grid* or *Slider*.
* **Design** – Select design style (*1, 2, 3,* etc.).
* **Font size** – Adjust collection title font size (default: *18px*).
* **Hover effect** – Select image hover interaction (*Zoom*, *None*, etc.).
* **Images style** – Choose between *Default* or *Rounded*.
* **Image ratio** – Define image ratio (*1:1*, *3:4*, *16:9*, etc.).
* **Custom ratio** – Set a custom aspect ratio manually (e.g., *21:9*).
* **Items per row (Desktop)** – Number of collections per row on desktop.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FLRchZI2TTyIXw7e28a0h%2Fimage.png?alt=media&amp;token=3aa6f621-790a-488e-af0e-c094a22e67c5" alt=""><figcaption></figcaption></figure>

***

### **Slider Settings**

* **Column gap** – Set spacing between collection items (in *px*).
* **Autoplay** – Automatically scroll collections.
* **Loop** – Enable continuous sliding.
* **Show arrows** – Display navigation arrows.
* **Show bullets** – Display pagination dots.
* **Items per row (Tablet)** – Number of collections shown per row on tablet.
* **Items per row (Mobile)** – Number of collections shown per row on mobile.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FhZXt7iBfrvuIPMWeDI2W%2Fimage.png?alt=media&amp;token=b8bcb106-3f7d-4dd7-a74b-a61037335143" alt=""><figcaption></figcaption></figure>

* **Height item** – Set the collection item height (default: *870px*).

***

### **Section Padding**

* **Padding top** – Adjust top spacing (default: *0px*).
* **Padding bottom** – Adjust bottom spacing (default: *0px*).
* **Remove default space between sections** – Creates seamless visual transitions.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FdYAvkR0mfOeYtGTjlQIn%2Fimage.png?alt=media&amp;token=efc8ebca-ad13-44b6-905e-f97dcdf7bfb7" alt=""><figcaption></figcaption></figure>

***

## **Block — Collection Item**

Displays a single collection inside the list.

* **Collection heading** – Title for the individual collection.
* **Select collection** – Choose a collection to feature.
* **Select image** – Upload or select a representative image.

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FgUqUotOm4LucqALjMQeF%2Fimage.png?alt=media&amp;token=62337438-2983-49ee-a768-79087fb6a289" alt=""><figcaption></figcaption></figure>

***

💡 **Tips:**

* For a clean and modern look, use consistent image ratios.
* Activate *Autoplay* for a dynamic, interactive layout.
* Ideal for homepage or category overview sections.
