> 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/section/featured-collection.md).

# Featured collection

The Featured Collection section displays a specific collection of products, ideal for promoting curated selections like Sale, Seasonal, or Best Sellers collections.

Show products from one collection on any page, with an optional "View all" link and a promotional card.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FFuJYPYsTXQr2RL4YQo7Y%2FScreenshot%202025-09-16%20at%2012.05.33%E2%80%AFPM.png?alt=media&amp;token=42f6df8f-140d-46cd-9b1b-2eccf15c0c97" alt=""><figcaption></figcaption></figure>

### 1. How to add the section

{% stepper %}
{% step %}
In the theme editor, click **Add section**.
{% endstep %}

{% step %}
Choose **Featured collection** (in the **Products** category).
{% endstep %}
{% endstepper %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2Fs1NQ7LIQn60Asc3Sx6yO%2FScreenshot%202025-10-01%20at%203.11.51%E2%80%AFPM.png?alt=media&amp;token=cf3b0199-38d0-4a16-b7a9-2ac37e402ce2" alt=""><figcaption></figcaption></figure>

### 2. Section settings

**General**

* **Collection:** the collection to show. You create collections in **Products > Collections** in your Shopify admin.
* **Maximum products to show:** 2 to 12 products.
* **Products per row on desktop:** 1 to 4.
* **Enable carousel on desktop:** shows the products in a single row that customers can scroll through.
* **Hide unavailable products:** hides products that are sold out or can't be bought.

**“View all” link**

* **Enable “View all” link if collection has more products than shown:** adds a link to the full collection when it has more products than you show. It appears at the end of the product list.
* **“View all” style:**
  * **Text:** a simple "View all" link.
  * **Card:** an extra card at the end of the list with the collection name and a "View all" link, shown over the image of the collection's first product.
* **Image overlay opacity** and **Overlay style:** darken the "View all" card image so the text is easy to read. Overlay style options: Gradient from bottom, Gradient from top or Full image darken.

**Product card**

* **Image ratio:** Adapt to image, Portrait or Square.
* **Show product rating:** shows star ratings on product cards. You need a product reviews app for this.
* **Show color swatches:** shows the available colors under each product.
* **Enable quick add button:** lets customers add products to the cart without leaving the page. See [Quick add](https://help.byinspiredlabs.com/theme-settings/quick-add.md).

**Mobile layout**

* **Products per row on mobile:** 1 product or 2 products.
* **Enable swipe on mobile:** lets customers swipe through the products on mobile.

{% 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 %}

### 3. Block settings

**Card**

Add one **Card** block to place a promotional image card at the start of the product list.

* **Image:** the card's background image.
* **Image overlay opacity** and **Overlay style:** darken the image so the text stays readable (Gradient from bottom, Gradient from top or Full image darken).
* **Card border:** None, Subtle or Solid.
* **Text:** a **Heading** (sizes Small, Medium or Large), a **Description** and the **Content position** (Middle left, Middle center, Middle right, Bottom left, Bottom center or Bottom right).
* **Button:** **Button label**, **Button link** and **Button style** (Solid, Outline or Text).
* **Colors:** turn on **Use custom colors** to pick the text color and the button color.
