# Subcollections

The **Subcollections** section allows merchants to display a curated set of related collections on a collection page. This is ideal for organizing complex catalogs and enhancing collection discoverability by guiding users to subcategories.

<figure><img src="/files/vbc3C2br0ni9yYGEqivp" alt=""><figcaption></figcaption></figure>

This section is only enabled on **collection templates**.

<table><thead><tr><th width="162.2117919921875">Settings</th><th width="175.88885498046875" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Subcollections</td><td align="center"><code>collection_list</code></td><td>Select collections to feature as subcollections.</td></tr><tr><td>Collection limit</td><td align="center"><code>range</code></td><td>Set how many subcollections to show.</td></tr><tr><td>Layout</td><td align="center"><code>select</code></td><td>Choose how to display items on desktop: <code>Grid</code>, or <code>Carousel</code>.</td></tr><tr><td>Image source</td><td align="center"><code>select</code></td><td>Select whether to <code>Use collection image</code> or <code>Use first product image</code>.</td></tr><tr><td>Image height ratio</td><td align="center"><code>range</code></td><td>Set the aspect ratio for subcollection images.</td></tr><tr><td>Overlay type</td><td align="center"><code>select</code></td><td>Adds an overlay: <code>Disabled</code> and <code>Opacity overlay</code>.</td></tr><tr><td><strong>Colors</strong></td><td align="center"></td><td></td></tr><tr><td>Color scheme</td><td align="center"><code>color_scheme</code></td><td>Select color scheme to apply to this section.</td></tr><tr><td><strong>Section spacing</strong></td><td align="center"></td><td></td></tr><tr><td>Padding top</td><td align="center"><code>range</code></td><td>Space above the section.</td></tr><tr><td>Padding bottom</td><td align="center"><code>range</code></td><td>Space below the section.</td></tr></tbody></table>

## Tips and Usage

* Subcollections improve navigation by guiding users from a parent collection to more specific subcategories.
* For best visual results, use consistent and high-quality images for collections.
* The **carousel layout** is suitable when horizontal scrolling is preferred, especially with more than 4 collections


---

# 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://palo-alto.presidiocreative.com/collections/subcollections.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.