> 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/collections/collection-highlights.md).

# Collection highlights

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FFjHA3oLfF3zCkrZjNk5I%2Fimage.png?alt=media&amp;token=ac9b3713-f6b2-473f-802e-ec7695509b9f" 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>Fixed 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**                                                                                                                                                                                                                                                                                                                                                                                           |
| **Subheading**                         | Use the subheading to provide additional context, supporting information.                                                                                                                                                                                                                                                                                                                                                                 |
| **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>                                                                                                                                                                                                                                                                                 |
| **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>                                                                                                                                                                                                                                                                   |
| **Show product count**                 | Show the current number of product in each collection                                                                                                                                                                                                                                                                                                                                                                                     |

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

| Setting                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Collection highlights width** | Setting the width for highlighted collections on desktop                                                                                                                                                                                                                                                                                                                                                                       |
| **Image ratio**                 | <p>The image ratio for the featured images of the blog posts:</p><ul><li><strong>Adapt to image</strong> - Uses the aspect ratio of the images. This prevents the images from being cropped.</li><li><strong>Portrait</strong> - Crops the images to use a 3:4 ratio.</li><li><strong>Square</strong> - Crops the images to use a 1:1 ratio</li><li><strong>Landscape</strong> - Crops the images to use a 4:3 ratio</li></ul> |
| **Content position**            | Setting the position of your collections' content                                                                                                                                                                                                                                                                                                                                                                              |
| **Content alignment**           | <p>2 options for the content alignment</p><ul><li><strong>Left</strong></li><li><strong>Center</strong></li></ul>                                                                                                                                                                                                                                                                                                              |
| **Items per row on desktop**    | Number of columns to display on desktop computers. Minimum: 2. Maximum: 4.                                                                                                                                                                                                                                                                                                                                                     |
| **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                                         |
| --------------------------- | --------------------------------------------------- |
| **Show navigation**         | Display the next and back controls for the carousel |
| **Show pagination**         | Display the pagination for the carousel             |
| **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

| Settings         | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| **Show divider** | Toggles the visibility of a horizontal divider line within the section. |

### Block settings

#### Collection highlights, Collection list

| Settings       | Description                                                                          |
| -------------- | ------------------------------------------------------------------------------------ |
| **Collection** | Select a collection to show                                                          |
| **Image**      | Use an image as the current collection's thumbnail ***(330px x 520px recommended)*** |
| **Title**      | Set a new title for your collection or leave it blank to use the collection's title  |