> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/testimonials.md).

# Testimonials

This section enhances credibility and trust by highlighting user experiences, with visual elements adding depth to each testimonial. If the number of reviews exceeds the available space, the section automatically converts into a slider format, ensuring a smooth and organized display.

*<mark style="color:red;">(Section screenshot)</mark>*

### **1, How to add section in theme editor:**

{% stepper %}
{% step %}
In your theme editor (**Customize**), scroll to the bottom of the template and select **Add Section**.
{% endstep %}

{% step %}
In the list, locate and select **Testimonials** section. The section will now be added to your page, ready for customization.
{% endstep %}
{% endstepper %}

*<mark style="color:red;">(Screenshot)</mark>*

### 2, Section settings

The **Section settings** control the overall appearance and behavior of the testimonials.

* **General settings:**
  * **Layout:** Define the position of the media (image or video) relative to the testimonial text: Left or Right.
  * **Media aspect ratio**: Adjust the ratio for images or videos displayed in testimonials on desktop: **Portrait or Square**.
  * **Number of columns on desktop:** Set the number of testimonials displayed per row, from 1 to 3 blocks/row.
  * **Secondary background**: Choose how the **Color scheme** is applied:&#x20;

{% tabs %}
{% tab title="None" %}
Applies the color scheme to both the content and background.&#x20;
{% endtab %}

{% tab title="Show as content background" %}
Applies the color scheme only to the content area, leaving the section background untouched.&#x20;
{% endtab %}

{% tab title="Show as section background" %}
Applies the color scheme only to the section background, leaving blocks unchanged.
{% endtab %}
{% endtabs %}

* **Colors settings:**
  * **Star rating color**: Use the color picker to define the color of the star rating, ensuring it aligns with your store’s branding.

### **3, Testimonial block settings:**

* **Image**: Upload a specific image for the testimonial, such as a product photo or customer-provided image.
* **Shopify-hosted video:** Upload a video directly to your Shopify store for seamless integration. Shopify-hosted videos ensure faster loading speeds and smoother playback. MP4 is recommended for maximum compatibility.
* **Star rating**: Use the slider to set a star rating for the testimonial, ranging from **0 to 5** in increments of **0.5**. **Set 0**: Hides the star rating for testimonials without ratings.
* **Review text**: Enter detailed feedback in this field.
* **Reviewer name**: Enter the customer's name.
* **Product picker:** Select a product to associate with the review, providing direct links for customers.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.byinspiredlabs.com/section/testimonials.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.