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

# Featured collection with product grid

A promo panel paired with a shoppable product grid — the section most stores use for New arrivals. Image or loop video on one side, the collection's products on the other.

**Featured collection with product grid** puts a reason next to the products: a subheading, a headline, a paragraph and a button on one side, and the collection's products on the other.

Use it for a **New arrivals** block, a seasonal drop, a bestsellers panel, or any collection that deserves a sentence of context. The promo side can carry a still image or a looping video, and the grid keeps loading more products as the shopper scrolls.

### How to add

{% stepper %}
{% step %}

#### Open the theme editor

In the Shopify admin, go to **Online Store → Themes** and click **Customize**.
{% endstep %}

{% step %}

#### Add the section

In the left sidebar click **Add section**. Under **Collections**, choose **Featured collection with product grid**. It belongs on the page body — any template will take it, but the header, footer and other section groups will not.
{% endstep %}

{% step %}

#### Pick a collection

Open the section and choose a collection in the **Collection** field.
{% endstep %}

{% step %}

#### Write the promo copy

Replace the placeholder subheading, heading and text, and set the button label.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Until you pick a collection, the section shows placeholder content in the theme editor and renders nothing on the live storefront. If a section has gone missing from your published page, an empty **Collection** field is almost always the reason.
{% endhint %}

<details>

<summary>Setting it up as New arrivals</summary>

1. In the Shopify admin, go to **Products → Collections** and create a collection called *New arrivals*.
2. Make it **automated**, with a condition such as *Product tag is equal to new*, or set it to **Manual** and add products yourself.
3. Open the collection, scroll to **Sort** and choose **Newest first**. This section shows products in the collection's own sort order, so this is what keeps the grid current.
4. Back in the theme editor, select that collection and set the subheading to *New arrivals*.
5. Add a lifestyle image or a short loop video on the promo side so the block reads as a campaign.

</details>

### Good to know

**Keep Infinite scroll on Button or Auto.** With *Disable* the grid shows only the first batch and gives the shopper no way to reach the rest — there are no page numbers in this section. To keep the grid short, lower **Items per batch** and keep the button.

**Products appear in the collection's own sort order.** The section applies no sorting or filtering of its own. To change the order, change the sort setting on the collection in the Shopify admin.

**Items per batch is both the page size and the load-more size.** The grid starts with that many products and adds the same number each time. The range is 2 to 50, the default is 8.

**Max columns number is a ceiling, not a fixed count.** If the collection has fewer products than the number you choose, the grid shrinks to match. Desktop never drops below two columns, mobile never below one.

**The media side follows a priority order.** A loop video wins over the image picker; with no video the custom image is used; with no custom image the collection's own featured image appears; with none of those you get a placeholder graphic.

**Focal point applies to the collection image, not to your own.** If you upload something in **Custom image**, set its focal point in the Shopify admin image editor — that one wins.

**Curly braces style part of a heading.** Anything you wrap in `{ }` in the heading or subheading uses the theme's accent style, for example `New { arrivals }`.

**Narrow content width does nothing while Image is set to Large.** Large is the default, so switch the image size to 50% or Small first.

**The button is inactive until a collection is picked.** It renders as a disabled element, which is what you see in the editor before you choose one.

### Customization ideas

* Put a short, silent loop video on the promo side — the theme handles autoplay and muting, and it lifts the section well above a flat image. One per page is plenty.
* Set the image to **50%** for a balanced split when your copy runs longer than a line or two. **Large** gives the media the upper hand, which suits a single strong headline.
* Stack two of these sections with different collections and mirrored image sides to build a rhythm down the home page.
* Match the card image ratio to your photography: square for flat-lay shots, portrait for apparel on a model.
* Turn on quick view and add to cart so the grid is shoppable without a trip to the product page, and add colour pills if your products come in several colours.
* Keep the heading to one line and the paragraph to two — the promo side competes with the products for attention, and the products should win. It costs more on mobile, where the panel stacks above the grid.

***

### Related

* [Featured collection with media](https://staylime.com/docs/avante-themes/sections/collections/featured-collection-with-media.md)
* [New arrivals collection](https://staylime.com/docs/avante-themes/sections/collections/new-arrivals-collection.md)
* [Related collections](https://staylime.com/docs/avante-themes/sections/collections/related-collections.md)
* [Image & video size recommendations](https://staylime.com/docs/avante-themes/faq/performance/image-and-video-size-recommendations.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://staylime.com/docs/avante-themes/sections/collections/featured-collection-with-product-grid.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
