> For the complete documentation index, see [llms.txt](https://shinedezign.gitbook.io/metro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shinedezign.gitbook.io/metro/overview/featured-collection.md).

# Featured collection

### Configure the section

Select the customize theme option. Click on the dropdown menu at the top of the page to select the **Home page** template.

From the side menu, select **Featured collection.**

Customize the section by utilizing the settings on the right side of the theme editor, as described below:

<table data-header-hidden><thead><tr><th width="281"></th><th></th></tr></thead><tbody><tr><td>General</td><td><strong>Section visibility</strong><br>Select from the options to select the visibility of this section:<br>-Always<br>-Small (On selecting this, the section will be visible on mobile devices only.)<br>-Large (On selecting this, the section will be visible on large devices only.)<br><br><strong>Color scheme</strong><br>Select any color scheme defined in the theme settings>Colors>Schemes.<br><br><strong>Background</strong><br>Choose the section background from below options:<br>- Solid<br>- Gradient<br><br><strong>Container width</strong><br>Choose the container width from below options:<br>- Small<br>- Standard<br>- Wide<br>- Edge</td></tr><tr><td>Section spacing</td><td><p><strong>Choose from</strong><br>Choose spacing for:<br>- Desktop<br>- Mobile<br><br><strong>Desktop: Top spacing</strong><br>Adjust the range bar to add spacing at the top of the section for desktop view.<br></p><p><strong>Desktop: Bottom spacing</strong><br>Adjust the range bar to add spacing at the bottom of the section for desktop view.<br></p><p><strong>Mobile: Top spacing</strong><br>Adjust the range bar to add spacing at the top of the section for mobile view.<br></p><p><strong>Mobile: Bottom spacing</strong><br>Adjust the range bar to add spacing at the bottom of the section for mobile view.</p></td></tr><tr><td>Collection</td><td><strong>Collection</strong><br>Choose any collection from the store library.<br><br><strong>Aspect ratio</strong><br>Choose the images ratio from below options:<br>- Adapt to image<br>- Square<br>- Portrait<br>- Portrait slim<br>- Landscape<br><br><strong>Product limit</strong><br>Adjust the range bar to determine the total number of products to display in this section.<br><br><strong>Enable 'View all' link</strong><br>Select this checkbox to show the 'View all' link.<br><br><strong>View all text</strong><br>Add text for the view all link.</td></tr><tr><td>Section header</td><td><p><em><strong>Heading</strong></em> </p><p><em>Add heading text.</em> <br><em>(<strong>Note</strong>: Enter ++ for a line break and wrap text in [ ] to apply the highlight settings.)</em><br><br><strong>Heading tag</strong><br>Specify heading code types from H1-H6, div, span or p tag for SEO and search engines for crawling purposes.<br><br><strong>Heading size</strong><br>Select the font size from the following options:<br>- Heading XL<br>- Heading L
<br>- Heading M<br>- Heading S<br>- Heading XS
<br>- Heading XXS<br><br><strong>Description</strong> </p><p>Add description text.  <br><br><strong>Description size</strong><br>Choose the font size from following options:<br>- Extra Large<br>- Large<br>- Medium<br>- Regular<br>- Small<br>- Extra small<br><br><strong>Alignment</strong><br>Choose the alignment from below options:<br>- Left<br>- Center<br>- Right<br><br>Highlight text<br><strong>Highlight style</strong><br>Choose the style from following options:<br>- None<br>- Underline<br>- Text color<br>- Gradient<br><br><strong>Font</strong><br>Choose the text font family from the following options:</p><p>- Heading <br>- Body <br>- Accent <br>(<em><strong>Note</strong>: These fonts can be changed in theme settings>typography.)</em><br><br><strong>Highlight</strong> <strong>color</strong><br>Choose any solid or gradient color for the heading's highlight text.</p></td></tr><tr><td>Desktop layout</td><td><strong>Layout</strong><br>Choose the layout from below options:<br>- Grid<br>- Carousel<br><br><strong>Number of columns in a row</strong><br>Adjust the range bar to determine the number of columns in a row, on the desktop view.<br><br><strong>Column gap</strong><br>Adjust the range bar to determine the gap between columns, on the desktop view.</td></tr><tr><td>Mobile layout</td><td><strong>Text alignment</strong><br>Choose the alignment from below options:<br>- Left<br>- Center<br>- Right<br><br><strong>Number of columns in a row</strong><br>Adjust the range bar to determine the number of columns in a row, on the mobile view.<br><br><strong>Column gap</strong><br>Adjust the range bar to determine the gap between columns, on the mobile view.<br><br><strong>Enable swipe</strong><br>Select this checkbox to enable the swipe of cards on mobile.</td></tr></tbody></table>

### Block settings: Promotional card

<table data-header-hidden><thead><tr><th width="285"></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td>Color scheme</td><td>Select any color scheme defined in the theme settings>Colors>Schemes.</td><td></td></tr><tr><td>Image
</td><td>Choose any image from the store library.</td><td></td></tr><tr><td>Aspect ratio</td><td>Choose the images ratio from below options:<br>- Adapt to image<br>- Square<br>- Portrait<br>- Portrait slim<br>- Landscape<br>- Adapt to product</td><td></td></tr><tr><td>Position in carousel view</td><td>Choose the position of card from the below options:<br>- First<br>- End</td><td></td></tr><tr><td>Card radius</td><td>Adjust the range bar to determine the gap between the columns.<br><em>(<strong>Note</strong>: Radius is automatically optimized for mobile.)</em></td><td></td></tr><tr><td>Content</td><td><p><strong>Content position</strong><br>Choose the content position from below options:<br>- Top: Left/Center/Right<br>- Middle: Left/Center/Right<br>- Bottom: Left/Center/Right<br><br><strong>Subheading</strong><br>Add subheading text. <br><br><em><strong>Heading</strong></em> </p><p><em>Add heading text.</em> <br><em>(<strong>Note</strong>: Enter ++ for a line break and wrap text in [ ] to apply the highlight settings.)</em><br><br><strong>Heading tag</strong><br>Specify heading code types from H1-H6, div, span or p tag for SEO and search engines for crawling purposes.<br><br><strong>Heading size</strong><br>Select the font size from the following options:<br>- Heading L
<br>- Heading M<br>- Heading S<br>- Heading XS
<br>- Heading XXS<br><br><strong>Description</strong> </p><p>Add description text.  <br><br><strong>Description font size</strong><br>Choose the font size from following options:<br>- Extra Large<br>- Large<br>- Medium<br>- Regular<br>- Small<br>- Extra small<br><br>Highlight text<br><strong>Highlight style</strong><br>Choose the style from following options:<br>- None<br>- Underline<br>- Text color<br>- Gradient<br><br><strong>Font</strong><br>Choose the text font family from the following options:</p><p>- Heading <br>- Body <br>- Accent <br>(<em><strong>Note</strong>: These fonts can be changed in theme settings>typography.)</em><br><br><strong>Highlight</strong> <strong>color</strong><br>Choose any solid or gradient color for the heading's highlight text<em>.)</em></p></td><td></td></tr><tr><td>Button</td><td><strong>Button text</strong><br>Enter the button label.<br><em>(Note: Leave the label blank to hide the button.)</em><br><br><strong>Button link</strong><br>Add the button link to redirect it.<br><br><strong>Open in new tab</strong><br>Select this checkbox to open the button link in next tab of browser.<br><br><strong>Button style</strong><br>Choose the button style from the following options:<br>- Primary button<br>- Secondary button<br>- Primary outline button <br>- Secondary outline button <br>- Link</td><td></td></tr><tr><td>Overlay</td><td><strong>Enable overlay</strong><br>Select this checkbox to show overlay on slide media.<br><br><strong>Style</strong><br>Choose from solid or gradient to determine the overlay style.<br><br><strong>Solid color</strong><br>Choose any color for the solid overlay.<br><br><strong>Gradient color</strong><br>Choose any color for the gradient overlay.</td><td></td></tr></tbody></table>


---

# 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 dynamically by asking a question.

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

```
GET https://shinedezign.gitbook.io/metro/overview/featured-collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.