# Featured collection row
{% hint style="info" %}
This feature was added in v5.0.0 on April 12, 2022. See our [changelog](/lorenza/readme/changelog.md) and [theme update guide](/lorenza/readme/theme-updates.md) to learn more.
{% endhint %}
The **Featured collection row** section displays a single-row carousel of products from a selected collection, with a title card as the first column.
See the [Featured collection section](/lorenza/sections/theme-sections/featured-collection.md) for a carousel of products with the heading above the section, or the [Featured collection grid](/lorenza/sections/theme-sections/featured-collection-grid.md) for an alternate layout.
## Set up section
Add this section to your template and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.
{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](/lorenza/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [use metafields and dynamic sources](/lorenza/general/adapting-your-theme/dynamic-content-with-metafields.md).
{% endhint %}
STEPS
In your theme editor (**Customize**):
1. Select a **Template** to edit from the dropdown menu in the top bar.
> Learn how to use templates in our [Templates guide](/lorenza/general/editing-themes/using-templates.md).
2. Under **Template**, click **(+) Add section** and select **Featured collection row**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.
4. Click on the **Featured collection row** section and click **Select collection** to choose which collection to feature.
## Add section headings and button
Add promotion text with multiple headings and add an optional call-to-action button to get customers shopping.
STEPS
In your theme editor (**Customize**):
1. Click on the **Featured collection row** section to open the section settings.
2. Change the **Small heading** text that displays above the Heading.
> We recommended using the **Small heading** as a label or category such as "Collections" or "Sale".
3. Change the **Heading** text for the section title.
> We recommended a short title of just a few words.
4. Change the **Subheading** text displayed below the heading.
> We recommend two or three short sentences.
5. Change the "Shop now" **Button text** for your call-to-action button.
> The button links to the selected feature collection.
> The most effective button labels ask your customers to do something (e.g. Get started, Join us, Shop now). To learn more, [read "What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380)
6. Click **Save**
## Section style and layout
Once you've added a featured collection and your section content, you can customize the overall look of the section.
STEPS
In your theme editor (**Customize**):
1. Click on the **Featured collection** section to open the section settings.
2. (*Optional*.) Use the **Section style** dropdown to use **Contrast** colors.
> The **Contrast** style uses the contrast colors in your **Theme Settings**.
3. Choose whether to **Enable animation** to show visual effects when scrolling, hovering, or interacting with the section.
4. Select a **Text position** for the section headings, either the **Left** or **Right** side of the row.
5. Select the number of **Columns** of products to display at one time. Choose between *2* and *4* columns.
6. To make your images a uniform shape and size, select the **Image aspect ratio** to crop your images to **Square**, **Landscape**, or **Portrait**.
> The default **Natural** setting will display the original orientation of your image.
7. Use the **Max width of text** slider to control the maximum width of the headings.
> Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.
8. Click **Save**.
> Learn how to use Lorenza's available templates in our [Templates guide](/lorenza/general/editing-themes/using-templates.md).
## Settings reference
Click on the section to find the following settings:
| Setting | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Small heading | Enter text to display as a small heading above the main heading. |
| Heading | Enter heading text to display as a section title. |
| Subheading | Enter subheading text to display below the heading. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's [Rich text editor manual](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor). |
| Button text | Change the "Shop now" text for your call-to-action button. The most effective button labels ask your customers to do something (e.g. Get started, Join us, Shop now). |
| Style | Use the Default or Contrast section style. The Contrast style uses the contrast colors in your Theme Settings. |
| Text position | Display the header and button either above or beside the products. |
| Columns | Use the slider to choose how many items should be displayed side by side. Choose between 2 and 4. |
| Image aspect ratio | Crop the shape of your images to Square, Landscape, or Portrait. Choose Natural to display the original image shape. |
| Max width of text | Use the slider to control the maximum width and line breaks of the headings. |
|
| |
***
> **Related links**
>
> [Featured collection grid](/lorenza/sections/theme-sections/featured-collection-grid.md)\
> [Product listing settings](/lorenza/products/product-listings.md)\
> [Collection pages](/lorenza/collection-pages/collection-pages.md)\
> [Shopify collections guide](https://help.shopify.com/en/manual/products/collections/collection-layout#change-the-sort-order-for-the-products-in-a-collection)
---
# 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://help.fluorescent.co/lorenza/sections/theme-sections/featured-collection-row.md?ask=
```
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.