# Testimonials

The **Testimonials** section displays quotes from customers, partners, or others in a carousel with feature images and links. Personalize each testimonial with a reviewer photo and their star rating of a product.

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

## Set up section

Add this section to any template (except Checkout) 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 %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

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](https://github.com/fluorescent/kb-lorenza/blob/main/general/editing-theme/using-templates.md).
2. Under **Template**, click **(+) Add section** and select **Testimonials**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.

</details>

## Add testimonial blocks

Add as many **Testimonial** blocks as you like, each with their own feature image.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click (**+) Add Testimonial** and/or click on the **Testimonial** block you wish to edit.

   ![](/files/uhfM9aq7SlHg2QRBgpWT)
2. Under **Testimonial Image**, click **Select image** to upload and select your image file. This image will display above the testimonial content.

   > Your image will appear in its original orientation by default. There are no required image dimensions but a **Square (1:1)** orientation is ideal.

   > See our article for image recommendations for Lorenza to learn more.
3. Add a **Product link**.

   > This lets customers click on the image to go to the link you've selected.
4. Add a **Star rating**.

   > Choose a star rating for the testimonials, between *0* and *5* stars.
5. Add a **Reviewer image** and a **Reviewer name** for the testimonial.

   > We recommend at 160px by 160px PNG image file.
6. Add the **Review** text.

   > We recommend keeping this to just a few sentences long.
7. (*Optional*.) Click and hold the drag handles **`⋮⋮`** to rearrange the blocks:

   ![](/files/cKm7iCMqgcf6VfaAedOf)

   > Click **Remove block** in the block settings to delete a block.

   > Click the **Eye icon** to hide or unhide a block.
8. Click **Save**.

</details>

## Section content and style

Change the overall style and layout of the section, along with headings and links.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Testimonials** section to open the section settings.

   ![](/files/PLT61t6baAIrhZJDJnLo)
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 above or beside the testimonial blocks.

   > Choose between *Top left*, *Top center*, *Top right*, *Middle left* or *Middle right* options.

   ![](/files/j9wwt1fNdSVWFTGDQZ7u)
5. Select the number of **Columns** of testimonials to display at once.

   > Choose between *2* and *4* columns. If the **Middle left** or **Middle right** text positions are used, the section headings display as one of the columns.

   On mobile, only one column displays at once.
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.

   ![](/files/sdAYXZGqCp4bXdpb1HGH)
7. Change the text for the **Small heading**, **Heading**, and **Subheading**.
8. Add a **Link** and **Link text** to display a call-to-action button.

   > The most effective button labels ask 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)

   ![](/files/p0jlOV6dbE7Zj8Ihnohf)

   > To learn how to change the style and shape of buttons across your site, see our [Buttons guide](/lorenza/theme-styles/buttons.md).
9. 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.
10. Click **Save**..

</details>

## 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). |
| Link 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.                                                                                                                                                                                                                                                              |
| Text position      | Display the header and button either above or beside the gallery items.                                                                                                                                                                                                                                 |
| 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.                                                                                                                                                                                                                            |

Click on the **Testimonial blocks** to find the following settings:

| Setting        | Description                                                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Image          | There are no required images dimensions. We recommend images with a minimum width of 2050px for optimal quality across all devices. |
| Product link   | Add a link to a product or page on your store.                                                                                      |
| Star rating    | Add a star rating to the testimonial, between 0 and 5 stars.                                                                        |
| Reviewer image | Add an image to be used as the reviewer's profile picture.                                                                          |
| Reviewer name  | Add the name of the person being quoted.                                                                                            |
| Review         | Add the reviewer's quote for the testimonial                                                                                        |

\\

***

> **Related links**
>
> [Quotes](/lorenza/sections/theme-sections/quotes.md)\
> [Rich text](/lorenza/sections/theme-sections/rich-text.md)


---

# 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/testimonials.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.
