> 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/new-arrivals-collection.md).

# New arrivals collection

The promo panel and product grid of Featured collection with product grid, sorted by creation date — a new arrivals block that maintains itself.

New arrivals collection is the same promo-plus-grid layout as [Featured collection with product grid](https://staylime.com/docs/avante-themes/sections/collections/featured-collection-with-product-grid.md): a subheading, a heading, a paragraph that can collapse, a button and a large image or looping video on one side, with the collection's products on the other. What differs is how the grid is filled. The collection is sorted by creation date, newest first, so once the section is set up it maintains itself — new products appear at the front, older ones drop off the end, and nobody has to open the home page again.

### How to add

{% stepper %}
{% step %}

#### Add the section

In the theme editor click **Add section**, then pick **New arrivals collection**.
{% endstep %}

{% step %}

#### Pick the collection

The section sorts this one **Collection** by creation date, newest first.
{% endstep %}

{% step %}

#### Write the promo copy

Fill **Subheading**, **Heading**, **Text** and **Button label**. Long copy can be folded behind a *Show more* link with the collapse settings.
{% endstep %}

{% step %}

#### Add the media and set the count

Upload a **Custom image** or a **Video**, then set **Products** — 3 to 50, 12 by default.
{% endstep %}
{% endstepper %}

### Good to know

**It is a promo section, not a bare list.** Everything the Featured collection with product grid promo side offers is here as well: subheading and heading with their own size, tag, colour and gradient; text with a collapse control and its own line counts and link labels; button label and style; vertical and horizontal text alignment; narrow content; the full product card set; and background animation with parallax and zoom, with separate mobile values. Set it up the same way.

**It covers one collection, not the whole store.** The section sorts the collection you picked and nothing else. For a store-wide feed, point it at a collection that holds everything — an automated collection with a condition every product matches.

**Newest means the product's creation date in Shopify.** Not the publish date, and not the date the product joined the collection. A product that is re-imported or duplicated gets a fresh creation date and moves to the front.

**Products is a hard count, and there is no infinite scroll.** 3 to 50, 12 by default. Unlike Featured collection with product grid, this section has no **Items per batch** and no load-more button — it shows that many products and stops. That is the trade for the automatic sorting, so fill **Button label** to send shoppers on to the collection page.

**The media follows the usual priority order.** **Video** wins over **Custom image**, and the collection's own image is the last fallback. **Enable pause control** and **Enable mute control** appear only once a video is uploaded.

{% hint style="info" %}
An automated collection built on a tag such as `new`, combined with this section, gives you a new-arrivals block you never open again. Tag a product and it appears; remove the tag and it leaves.
{% endhint %}

### Customization ideas

* Set **Products** to a multiple of your grid width so the last row is full.
* Run two copies of the section on two collections for a two-tier "new in" story, with **Swap image position** mirrored so the page zigzags.
* Use [New arrivals tabs](https://staylime.com/docs/avante-themes/sections/collections/new-arrivals-tabs.md) instead when more than one collection needs the same treatment inside one section.
* Reach for [Featured collection with product grid](https://staylime.com/docs/avante-themes/sections/collections/featured-collection-with-product-grid.md) when the grid has to keep loading past the first batch — the layout is the same, the loading is not.

***

### Related

* [New arrivals tabs](https://staylime.com/docs/avante-themes/sections/collections/new-arrivals-tabs.md)
* [Featured collection with product grid](https://staylime.com/docs/avante-themes/sections/collections/featured-collection-with-product-grid.md)
* [Collections](https://staylime.com/docs/avante-themes/sections/collections.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/new-arrivals-collection.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.
