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

# Featured collection

This block showcases product images, titles, prices, and optionally, quick add or badge elements. Ideal for driving attention to high-priority products directly from the homepage or landing pages.

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FkMc8hUqHxcl4uamFnE7Q%2Fimage.png?alt=media&amp;token=8549cde1-fe29-4c39-9f32-4d54877f08ed" alt=""><figcaption></figcaption></figure>

### Section settings <a href="#section-settings" id="section-settings"></a>

#### General settings <a href="#general-setting" id="general-setting"></a>

| Setting           | Description                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Section width** | <p>3 options for container</p><ul><li><strong>Stretch width</strong>: span the section width regardless of screen size.</li><li><strong>Fix width:</strong> depends on your page content width in <strong>Theme settings</strong> <strong>-></strong> <strong>Layout</strong>.</li><li><strong>Expand full width</strong>: takes up the entire space on the page and it usually resizes itself to fit the size of the screen.</li></ul> |
| **Color scheme**  | Select colors from **Theme settings -> Colors**                                                                                                                                                                                                                                                                                                                                                                                         |

#### Section header <a href="#general-setting" id="general-setting"></a>

| Setting                                | Description                                                                                                                                               |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Subheading**                         | Use the subheading to provide additional context, supporting information, or a short description.                                                         |
| **Heading**                            | The primary text element used to introduce or label the content within this section.                                                                      |
| **Enable heading underline animation** | Enable heading underline animation                                                                                                                        |
| **Underline style**                    | Select Underline style                                                                                                                                    |
| **Underline color**                    | Customize Underline color                                                                                                                                 |
| **Description**                        | A text element used to provide additional details or supporting information related to the heading or content of the section.                             |
| **Heading size**                       | <p>The size of the title:</p><ul><li><strong>Small</strong></li><li><strong>Medium</strong></li><li><strong>Large</strong></li></ul>                      |
| **Alignment**                          | <p>The position of the heading and description.</p><ul><li><strong>Left</strong></li><li><strong>Center</strong></li><li><strong>Right</strong></li></ul> |
| **Show view all button**               | Displays a call-to-action button that links to the full collection associated with the section.                                                           |
| **Button label**                       | Set the text displayed on the button.                                                                                                                     |
| **Button type**                        | <p>3 options for Button type</p><ul><li>Primary</li><li>Outline</li><li>Link</li></ul>                                                                    |

#### Collection <a href="#blog-posts" id="blog-posts"></a>

| Setting                      | Description                                                                                                                                                            |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Collection**               | Select the collection you want to display                                                                                                                              |
| **Maximum items to show**    | Limit the display of the number of posts. Minimum: 2. Maximum: 12.                                                                                                     |
| **Items per row on desktop** | Number of columns to display on desktop computers. Minimum: 2. Maximum: 6.                                                                                             |
| **Column gap**               | <p>4 options for column gap</p><ul><li><strong>No gap</strong></li><li><strong>Small</strong></li><li><strong>Medium</strong></li><li><strong>Large</strong></li></ul> |

#### Carousel settings <a href="#settings-for-carousel" id="settings-for-carousel"></a>

| Setting                     | Description                                                    |
| --------------------------- | -------------------------------------------------------------- |
| **Enable carousel**         | When enabled, the section will be displayed in carousel format |
| **Show navigation**         | Display the next and back controls for the carousel            |
| **Show pagination**         | Display the pagination for the carousel                        |
| **Reveal next slide**       | Display a part of the upcoming slide.                          |
| **Items per row on mobile** | Number of columns to display on mobile devices.                |

#### Section padding <a href="#section-padding" id="section-padding"></a>

| Setting    | Description                                |
| ---------- | ------------------------------------------ |
| **Top**    | Customize the top margin of the section    |
| **Bottom** | Customize the bottom margin of the section |

#### Section divider

<table><thead><tr><th width="213">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Show divider</strong></td><td>Toggles the visibility of a horizontal divider line within the section.</td></tr></tbody></table>