# Testimonials

{% hint style="danger" %} <mark style="color:red;">Theme retirement</mark> Ira is no longer available on the Shopify theme store. **Theme support and updates for current users will end after May 18, 2024**. [Learn more here](/ira/readme/theme-retirement.md).
{% endhint %}

Use the **Testimonials** section to display rows of quotes from customers or partners about your products and store.

## 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](/ira/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [insert dynamic content with metafields](/ira/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](/ira/general/editing-themes/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

{% hint style="info" %}
**Update** | New image aspect ratio options were added to v4.0 on April 27 2022. See our [changelog](https://fluorescent.co/help/ira/changelog) and [theme update guide](/ira/readme/theme-updates.md) to learn more.
{% endhint %}

Add up to 8 testimonials with reviews from your customers and partners.

**Note**: If *every* testimonial block has an image, the section will appear as a single-row carousel on mobile devices.

<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.
2. Under **Image**, click **Select image** to upload and select your image file. This image will display above the testimonial content.
3. 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 each image.

   ![](/files/FAfTbG985emz2oT4gbzU)
4. Add a short few sentences to the **Testimonial** text.
5. Add the **Author** name of the person quoted.
6. (*Optional*.) Click and hold the drag handles **`⋮⋮`** to rearrange the blocks:

   ![](/files/pPiYJWvLmIKmIyFQAxdJ)

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

   > Click the **Eye icon** to hide or unhide a block.
7. Click on the **Testimonials** section, to choose how many **Testimonials per row** to display.

   > Choose between **2**, **3**, and **4**.
8. Click **Save**.

</details>

## Section headings and layout

You can add a main **Heading** and **Subheading**, change the number of **testimonials per row**, set the **text alignment**.

<details>

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

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

1. Click the **Testimonials** section to open the settings.
2. Use the **Columns per row** slider to adjust the number of testimonials per row, between *2*, *3*, or *4*.

   > On mobile, testimonials are displayed in a single column.
3. (*Optional*.) Add a **Heading** to display at the top of the section.
4. (*Optional*.) Add a **Subheading**.

   > Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's [Rich text editor guide](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor).
5. (*Optional*.) Select a **Link** to link to a page of testimonials and change the **Link text**.

   > We recommend one or two words.
6. Click **Save**.

</details>

## Settings reference

Click the **Testimonial blocks** to find the following settings.

| Setting     | Description                                                                                                                                                  |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Image       | Add a text as a heading for the testimonial.                                                                                                                 |
| Testimonial | Add the quote text for the testimonial. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide. |
| Author      | Add the name of the person being quoted.                                                                                                                     |

Click the **Testimonial** section to find the following settings.

| Setting              | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| Heading              | Add text to show a main heading.                                  |
| Link                 | Select or paste a link.                                           |
| Link text            | Add custom text for the link label.                               |
| Testimonials per row | Select the number of post blocks to show in each row for desktop. |
| <p><br></p>          |                                                                   |

***

> **Related links**
>
> [Rich text](/ira/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/ira/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.
