# Featured collection

{% hint style="danger" %} <mark style="color:red;">Theme retirement</mark> | Context is no longer available on the Shopify theme store. **Theme support and updates for current users will end after May 18, 2024**. [Learn more here](/context/readme/theme-retirement.md).
{% endhint %}

The **Featured collection** section displays a grid of products from a selected collection. With [Quick shop](/context/cart/quick-shop.md) enabled, customers can add these products directly to their cart.

## Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](/context/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [insert dynamic content with metafields](/context/general/adapting-your-theme/dynamic-content-with-metafields.md).
{% endhint %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Select a **Template** to edit from the dropdown menu in the top bar.

   > Learn how to use templates in our [Templates guide](/context/general/editing-themes/using-templates.md).
2. Under **Template**, click **(+) Add section** and select **Featured collection**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.

</details>

### Select featured collection

Select a **Collection** to display its products in a grid with adjustable rows and columns.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click the **Featured collection** section.
2. Use the **Select collection** button find the collection you want to feature.

   > We recommend collections with at least 4 products.
3. Click **Save**.

</details>

## Section content and layout

Add content with a section heading. Adjust the layout by changing the number of products per row and the shape (aspect ratio) of product images.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click the **Featured collection** section to open the settings.
2. Enter **Heading** text to display in the top-left of the section.

   > We recommend a short title of 2 to 3 words.
3. Enter **Subheading** text to display below the heading.
4. Add **Link text** to show a text link to the collection page.

   > We recommend a one or two words (e.g. "Shop now").
5. Use the sliders to set the number of **Products per row** and number of **rows** to change the layout.

   > On mobile, products are shown in a two-column row that customers can tap through as a carousel.
6. Set the **Heading alignment** to **Left**, **Right**, or **Center**.

   > This option changes the layout of the section:

   ![](/files/8LQC5twtvsiyao7UC1Lv)
7. To make your images a uniform shape and size, select the **Image aspect ratio** to crop your images to **Square**, **Landscape**, or **Portrait**.

   > The default **Natural** setting will display the original orientation of each image.

   ![](/files/tegKTYjZOsUIxM4dpUdE)
8. Click **Save**.

</details>

## Settings reference

Click the **Featured collection** section to find the following settings.

| Setting            | Description                                                                                                                                                                                                                    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Select collection  | Select a collection from your store's existing collections.                                                                                                                                                                    |
| Heading            | Add text to show a main heading.                                                                                                                                                                                               |
| Subheading         | Add text to show a subheading below the main heading.                                                                                                                                                                          |
| Heading alignment  | Choose where to position the heading and subheading. Either Left, Center, or Right.                                                                                                                                            |
| Link text          | Add text that should be used as a call to action to view the collection. For example, "Shop now".                                                                                                                              |
| Products per row   | Change the amount of products shown per row. You can choose between 2 and 4 products per row. On mobile devices the amount of products per row might change. This depends on the screen width of the customer's mobile device. |
| Rows               | Change how many rows of products from the collection should be displayed. Choose between 1 and 3.                                                                                                                              |
| Image aspect ratio | Choose to crop all images to be a single uniform shape. Select Portrait (2:3), Square (1:1), or Landscape (3:2). Select Natural to display images in their original shape (without cropping).                                  |
| <p><br></p>        |                                                                                                                                                                                                                                |

***

> **Related links**\
> [Collection pages](/context/collection-pages/collection-pages.md)\
> [Shopify collections guide](https://help.shopify.com/en/manual/products/collections/collection-layout#change-the-sort-order-for-the-products-in-a-collection)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.fluorescent.co/context/sections/theme-sections/featured-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
