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

# Product grid

The Product grid section organizes and displays products on collection pages, allowing customers to browse efficiently while using filtering and sorting options.

The Product grid shows the products in a collection, with filtering and sorting so customers can find what they want quickly. You can also place promotion images between the products.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2Fibz8pQpwTPvYLACCuCbd%2FScreenshot%202025-09-23%20at%2011.10.57%E2%80%AFAM.png?alt=media&amp;token=5026c584-64a2-4036-a0bf-cf30c2622f23" alt=""><figcaption></figcaption></figure>

### 1. Section settings

* **Products per page:** How many products show on each page, from 8 to 48.
* **Number of columns on desktop:** 2, 3 or 4 products per row.
* **Show product total:** Shows how many products are in the collection.
* **Filtering and sorting:**
  * **Enable sorting:** Lets customers sort products, for example by Best selling, Alphabetically A-Z, Price low to high or Date new to old.
  * **Enable filtering:** Shows filters so customers can narrow down the products. Shopify sets up the available filters; you can add more with the Search & Discovery app (see below).
  * **Filters layout:** Where the filters show on desktop.
  * **Open filters by default:** Shows the filter groups expanded when the page loads.

{% tabs %}
{% tab title="Sidebar" %}
Filters appear in a column next to the product grid on desktop.
{% endtab %}

{% tab title="Drawer" %}
Filters appear in a panel that slides out when customers click **Filter**.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Note:** The sidebar layout is for desktop only. On tablet and mobile, filters and sorting always open in a drawer from the **Filter and sort** button. The drawer's position and colors follow [Theme settings > Drawers](https://help.byinspiredlabs.com/theme-settings/drawers.md).
{% endhint %}

* **Product card:**
  * **Image ratio:** The shape of product images. Options: Adapt to image, Portrait or Square.
  * **Show product rating:** Shows star ratings from a product reviews app.
  * **Show color swatches:** Shows color swatches on product cards.
  * **Enable quick add button:** Adds a quick add button to product cards so customers can add to cart without leaving the page. What the button looks like and what it does are set in [Theme settings > Quick add](https://help.byinspiredlabs.com/theme-settings/quick-add.md).
* **Mobile layout:**
  * **Number of columns on mobile:** 1 or 2 products per row.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}

<details>

<summary>How to set up filters?</summary>

Customers can filter products by options such as:

✅ **Availability**

✅ **Price range**

✅ **Product type**

✅ **Vendor**

✅ **Variant options**

By default, the filters include **Availability** and a **Price** range. You can add more filter options with Shopify's [Search & Discovery app](https://apps.shopify.com/search-and-discovery). Steps:

* In the [Shopify Search & Discovery app](https://admin.shopify.com/apps/search-and-discovery), go to **Filters**, and then click **Add filter**.

<figure><img src="https://t9008110498.p.clickup-attachments.com/t9008110498/d86f4875-389c-4476-936b-efb9b5a4cbab/Screenshot%202025-03-12%20at%202.57.44%E2%80%AFPM.png" alt=""><figcaption></figcaption></figure>

* Select a **Source** for the filter options. Sources can be variant options, tags, or metafields.

<figure><img src="https://t9008110498.p.clickup-attachments.com/t9008110498/3d3cca94-fcf0-43e3-b38f-d4e3ebbe489a/Screenshot%202025-03-12%20at%202.59.57%E2%80%AFPM.png" alt=""><figcaption></figcaption></figure>

* Add a **Filter label** to change the filter group name that customers see.

<figure><img src="https://t9008110498.p.clickup-attachments.com/t9008110498/7e94cd98-b1ab-4578-ac83-11b687fb7a45/Screenshot%202025-03-12%20at%203.02.50%E2%80%AFPM.png" alt=""><figcaption></figcaption></figure>

* Click **Save**.

</details>

### 2. Promotion image block settings

The **Promotion image** block places an image, with optional text and a button, between the products in the grid. You can add several.

* **Image:** The image to show.
* **Position in grid:** Where the block appears among the products, from 1 to 49. For example, 5 places it before the fifth product.
* **Desktop image width:** How much space it takes in the grid. Options: 1 column, 2 columns or Full width.
* **Image overlay opacity:** Darkens the image so text is easier to read, from 0 to 100.
* **Text:**
  * **Heading:** A short title, such as "Spring Sale".
  * **Heading size:** Small, Medium or Large.
  * **Description:** Supporting text below the heading.
  * **Content position:** Where the text sits on the image. Options: Middle left, Middle center, Middle right, Bottom left, Bottom center or Bottom right.
* **Button:**
  * **Button label:** The button text. Leave empty to hide the button.
  * **Button link:** Where the button goes.
  * **Button style:** Solid, Outline or Text.
* **Colors:**
  * **Use custom colors:** Turn on to use the colors below.
  * **Text:** The color of the heading and description.
  * **Button:** The color scheme of the button.
* **Mobile layout:**
  * **Mobile image width:** 1 column or 2 columns.
