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

# Product grid

This article provides step-by-step guidance on customizing and displaying a grid view list of products based on a specific category on your collection page.

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FA1RzXxIxqYwa2c5Qm0dK%2Fimage.png?alt=media&amp;token=92f7dd0a-e183-49d6-81b1-29569aa196d9" alt=""><figcaption></figcaption></figure>

## How to add a Product grid section?

{% hint style="success" %}
Steps

1. In the theme editor (**Customize**), open the template selector.
2. Select **Collections**, then **Default collection.**
3. On the left-sidebar, add **Product grid.**
4. Make necessary changes > **Save.**
   {% endhint %}

## How to customize your Product grid section

### General Settings

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FM6y3sFvOX8OVmIT2nFeO%2Fimage.png?alt=media&amp;token=54189b53-4dab-4db5-85fc-c5eb5bd7fc2e" alt=""><figcaption></figcaption></figure>

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Section width</strong></td><td><p>3 options for section width</p><ul><li><strong>Stretch width</strong>: span the section width regardless of screen size.</li><li><strong>Fixed width</strong>: depends on your page content width in <strong>Theme settings</strong> <strong>-></strong> <strong>Layout</strong>.</li><li><strong>Full width</strong>: takes up the entire space on the page and it usually resizes itself to fit the size of the screen.</li></ul></td></tr><tr><td><strong>Items to show per page</strong></td><td>Limit the display of the number of page. Minimum: 4. Maximum: 24</td></tr><tr><td><strong>Columns per row on desktop</strong></td><td>Number of columns to display on desktop computers. Minimum: 2. Maximum: 5.</td></tr><tr><td><strong>Column gap</strong></td><td><p>4 options for column gap</p><ul><li><strong>Small</strong></li><li><strong>No gap</strong></li><li><strong>Medium</strong></li><li><strong>Large</strong></li></ul></td></tr></tbody></table>

**Pagination type**

{% tabs %}
{% tab title="Page number" %}

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FQF4WgcwtYff28mudZ7Xo%2Fimage.png?alt=media&amp;token=96ac131c-5671-4ee0-98e0-bad721218e61" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Load more button" %}

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FK9dvyOtMtxmVkH28MtPs%2Fimage.png?alt=media&amp;token=41321a7f-8532-4719-9f64-d1940036e5ae" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Infinite scroll" %}

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FTmWG5JAKx53pu4Hi0EU4%2Fimage.png?alt=media&amp;token=1e0265c9-060d-4594-ab85-b50aeb098b5c" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Filtering and sorting

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2F2ojZzOgKP8cCMpWl7Oha%2Fimage.png?alt=media&amp;token=813f241d-2294-4b8e-a14b-783f47c70ee5" alt=""><figcaption></figcaption></figure>

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable sorting</strong></td><td>When enabled, it will display sorting options for arranging products</td></tr><tr><td><strong>Enable filtering</strong></td><td>When enabled, it will display the configured filter options, allowing you to filter products</td></tr><tr><td><strong>Show product counts</strong></td><td>Display the quantity of product</td></tr><tr><td><strong>Desktop filter layout</strong></td><td>3 options for desktop filter layout</td></tr></tbody></table>

{% hint style="info" %}
To customize filters in your store, you will need the [Shopify Search & Discovery](https://apps.shopify.com/search-and-discovery) app.

This app not only enables you to tailor your filters but also grants you the capability to personalize search results and product recommendations, providing you with greater control over how customers explore and find your products.

Discover [how to customize filters using the app.](https://help.shopify.com/en/manual/online-store/search-and-discovery/filters)
{% endhint %}

### Section padding

<table><thead><tr><th width="168">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Top</strong></td><td>Customize the top margin of the section</td></tr><tr><td><strong>Bottom</strong></td><td>Customize the bottom margin of the section</td></tr></tbody></table>

### Block settings

**Promotion**

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2Fxie6fWB262i0cRgMazrt%2FScreenshot_130.png?alt=media&amp;token=be5022c5-1b56-45d7-ad2b-78f80699fb44" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="146">Text</th><th>Description</th></tr></thead><tbody><tr><td><strong>Image</strong></td><td>Upload banner promotion image <em><strong>(330px 550px recommended)</strong></em></td></tr><tr><td><strong>Subheading</strong></td><td>Add a short line above the main heading.</td></tr><tr><td><strong>Heading</strong></td><td>Title of the promotion</td></tr><tr><td><strong>Description</strong></td><td>Supporting text to describe the promotion's message.</td></tr><tr><td><strong>Button label</strong></td><td>Name for the button</td></tr><tr><td><strong>Link</strong></td><td>The link URL you want to add</td></tr><tr><td><strong>Promotion position</strong></td><td>The banner will display if its position is equal to or less than the number of products in the collection; otherwise, it won't be shown.</td></tr></tbody></table>

**Shop by step**

* Image: Upload banner promotion image ***(337px x 200px recommended)***
* Heading
* Description
* Button label
* Link