> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testimonials

> Display customer reviews and feedback with images, flexible layouts, and autoplay carousel functionality.

The Testimonials section showcases customer feedback and reviews in a visually engaging slideshow format. It features customizable layouts with optional images, autoplay functionality, and flexible content width options to build trust and social proof.

<img src="https://mintcdn.com/digifist/wRt80VzqWyH-a_6u/images/theme/sahara/sections/testimonials/testimonials-overview.png?fit=max&auto=format&n=wRt80VzqWyH-a_6u&q=85&s=41031fb80030b86aa02b7d4aa7428f28" alt="Testimonials section overview" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/testimonials-overview.png" />

## What this section controls

This section controls customer testimonial displays with the following capabilities:

* Multiple testimonial slides with quotes and attribution
* Image positioning (left, right, or no image)
* Narrow or full-width content layouts
* Autoplay carousel functionality
* Optional clickable links on testimonials
* Section-level heading and styling

## How the Testimonials section works

The section uses testimonial blocks where each block represents one customer review. When multiple testimonials are added, they automatically form a carousel that can rotate manually or automatically. The image position setting determines whether a featured image appears alongside the testimonials.

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Add Testimonials section">
    Add the Testimonials section to your page or template.
  </Step>

  <Step title="Add testimonial blocks">
    Click "Add block" and select "Testimonial" to add customer reviews.
  </Step>

  <Step title="Configure content">
    Add quotes, author names, and optional images for each testimonial.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/wRt80VzqWyH-a_6u/images/theme/sahara/sections/testimonials/testimonials-location.png?fit=max&auto=format&n=wRt80VzqWyH-a_6u&q=85&s=b5460b266d6f7b38f32b2478f23a7406" alt="Testimonials section in Theme Customizer" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/testimonials-location.png" />

## Section settings

<Tabs>
  <Tab title="Layout">
    ### Layout

    Controls the position of the featured image relative to testimonial content.

    <AccordionGroup>
      <Accordion title="Image left" icon="arrow-left">
        Featured image appears on the left side, testimonials on the right.

        **When to use:**

        * When image is equally important as testimonials
        * Left-to-right reading flow emphasis
        * Desktop-friendly balanced layouts
      </Accordion>

      <Accordion title="Image right" icon="arrow-right">
        Featured image appears on the right side, testimonials on the left (default).

        **When to use:**

        * Standard testimonial layouts
        * When content should be read first
        * Maintaining left-aligned text focus
      </Accordion>

      <Accordion title="No image" icon="align-center">
        No featured image displayed, testimonials use full width.

        **When to use:**

        * Text-focused testimonial sections
        * When individual testimonial images are sufficient
        * Minimal, clean designs
        * Mobile-optimized displays
      </Accordion>
    </AccordionGroup>

    <img src="https://mintcdn.com/digifist/wRt80VzqWyH-a_6u/images/theme/sahara/sections/testimonials/layout-options.png?fit=max&auto=format&n=wRt80VzqWyH-a_6u&q=85&s=3e82668a1349061bd23ae14e7cb3c81c" alt="Layout options comparison" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/layout-options.png" />

    ### Content width

    Controls the maximum width of testimonial text content.

    <AccordionGroup>
      <Accordion title="Narrow" icon="compress">
        Content constrained to a narrow column for better readability (default).

        **When to use:**

        * Longer testimonial quotes
        * Improving text readability
        * Creating visual focus on content
      </Accordion>

      <Accordion title="Full" icon="expand">
        Content uses the full available width.

        **When to use:**

        * Short, concise testimonials
        * Maximizing screen space
        * When using "No image" layout
      </Accordion>
    </AccordionGroup>

    <Tip>
      Narrow content width typically provides better readability for testimonials, especially on large screens.
    </Tip>
  </Tab>

  <Tab title="Carousel">
    ### Autoplay interval

    Controls automatic slide rotation timing.

    **Range:** 0 – 10 seconds (in 0.5 second increments)\
    **Default:** 3 seconds

    <AccordionGroup>
      <Accordion title="Autoplay behavior" icon="play">
        **Setting to 0 seconds:**

        * Disables autoplay completely
        * Users must manually navigate between testimonials
        * Best for detailed reviews that need reading time

        **Setting to 3-5 seconds:**

        * Recommended for short testimonials
        * Balanced between visibility and user control
        * Keeps content dynamic without rushing

        **Setting to 6-10 seconds:**

        * Best for longer quotes
        * Gives users time to read thoroughly
        * Less frequent changes reduce distraction
      </Accordion>
    </AccordionGroup>

    <Warning>
      Intervals under 3 seconds can frustrate users who are reading testimonials. Allow sufficient time for comprehension.
    </Warning>

    <img src="https://mintcdn.com/digifist/RBPy16iLJPPXysmx/images/theme/sahara/sections/testimonials/autoplay-interval.png?fit=max&auto=format&n=RBPy16iLJPPXysmx&q=85&s=329c66d300e884b4606a02a1b4c1478e" alt="Autoplay interval setting" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/autoplay-interval.png" />
  </Tab>

  <Tab title="Content">
    ### Title (Heading)

    Main section heading displayed above testimonials.

    **Default:** "From the people"

    Supports rich text formatting (bold, italic, links).

    ### Heading size

    Controls the visual size of the section heading.

    **Available options:** XS (default), S, M, L, XL

    <Tip>
      Use XS or S for testimonials to maintain focus on customer quotes rather than the heading.
    </Tip>
  </Tab>

  <Tab title="Styling">
    ### Section width

    Controls the maximum width of the entire section container.

    <AccordionGroup>
      <Accordion title="Page width" icon="window-restore">
        Content limited to theme's page width (default).

        **When to use:** Standard sections that align with other page content.
      </Accordion>

      <Accordion title="Fluid" icon="arrows-left-right">
        Content extends wider but with some padding.

        **When to use:** Emphasizing testimonials without full edge-to-edge.
      </Accordion>

      <Accordion title="Full width" icon="expand">
        Content extends to full browser width with no side padding.

        **When to use:** Edge-to-edge designs, maximizing visual impact.
      </Accordion>
    </AccordionGroup>

    ### Color scheme

    Select the background and text color scheme for the section.

    ### Spacing

    Control vertical spacing around the section:

    * **Spacing top** - Margin above the section (None, S, M, L, XL)
    * **Spacing bottom** - Margin below the section (None, S, M, L, XL)

    Both default to M (medium spacing).

    ### Section border

    Add decorative borders to the section.

    **Available options:** None (default), Top, Bottom, Both

    <img src="https://mintcdn.com/digifist/r8ZuiInWhcXEnvSN/images/theme/sahara/sections/testimonials/section-border.png?fit=max&auto=format&n=r8ZuiInWhcXEnvSN&q=85&s=a0c28c054e6de1101fd7cd714fae92b0" alt="Styling and spacing options" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/section-border.png" />
  </Tab>
</Tabs>

## Block settings

Each testimonial block represents one customer review or quote.

<Tabs>
  <Tab title="Media">
    ### Image

    Upload an image for this specific testimonial.

    <AccordionGroup>
      <Accordion title="Testimonial images" icon="image">
        **Common image uses:**

        * Product photos related to the review
        * Customer photos (with permission)
        * Lifestyle imagery matching testimonial context
        * Brand or logo images for B2B testimonials

        **Image recommendations:**

        * Square or portrait orientations work best
        * High resolution (at least 500px)
        * Consistent styling across all testimonials
        * Properly optimized for web

        <Note>
          This is the image shown in the carousel slide, separate from the section's featured image.
        </Note>
      </Accordion>
    </AccordionGroup>

    <img src="https://mintcdn.com/digifist/wRt80VzqWyH-a_6u/images/theme/sahara/sections/testimonials/testimonial-image.png?fit=max&auto=format&n=wRt80VzqWyH-a_6u&q=85&s=15bd021fae817f0db36c37d256326fca" alt="Testimonial image option" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/testimonial-image.png" />
  </Tab>

  <Tab title="Text">
    ### Quote

    The main testimonial text or customer review.

    <AccordionGroup>
      <Accordion title="Writing effective quotes" icon="quote-right">
        **Best practices:**

        * Keep testimonials authentic and unedited (or minimally edited)
        * Aim for 20-50 words for optimal readability
        * Include specific details (product names, features, benefits)
        * Avoid generic praise ("Great product!") in favor of specific feedback
        * Use rich text sparingly (emphasize key phrases only)

        **Example:**
        Good: "The Leo Bikini Bottoms fit perfectly and the fabric quality exceeded my expectations. I've worn them all summer!"

        Too generic: "Great quality, highly recommend!"
      </Accordion>
    </AccordionGroup>

    **Default:** "I absolutely love the quality of my Leo Bikini Bottoms."

    Supports rich text formatting.

    ### Author

    Name of the person providing the testimonial, optionally with date or location.

    **Format examples:**

    * "Jane Doe"
    * "Jane Doe, 2022"
    * "Jane D., New York"
    * "J.D., Verified Customer"

    **Default:** "Jane Doe, 2022"

    <Tip>
      Adding dates or "Verified Customer" labels increases credibility and trustworthiness.
    </Tip>
  </Tab>

  <Tab title="Link">
    ### Link title

    Optional button or link text displayed with the testimonial.

    <AccordionGroup>
      <Accordion title="When to use links" icon="link">
        **Use links to:**

        * Direct to the reviewed product page
        * Link to full review or case study
        * Connect to customer's social profile (if permitted)
        * Drive traffic to related collection

        **Link text examples:**

        * "Buy Leo Bikini Bottoms"
        * "Read full review"
        * "Shop this collection"
        * "See more reviews"

        Leave empty if testimonial doesn't need a call-to-action.
      </Accordion>
    </AccordionGroup>

    **Default:** "Buy Leo Bikini Bottoms"

    ### Link URL

    Destination URL for the testimonial link.

    <AccordionGroup>
      <Accordion title="Link URL options" icon="arrow-up-right-from-square">
        **Common destinations:**

        * Product page: `/products/product-handle`
        * Collection page: `/collections/collection-handle`
        * Full review page: `/pages/reviews`
        * External review platform (Trustpilot, Google, etc.)

        <Note>
          If link URL is empty, no link or button will display even if link title is set.
        </Note>
      </Accordion>
    </AccordionGroup>

    **Default:** "/"

    <img src="https://mintcdn.com/digifist/r8ZuiInWhcXEnvSN/images/theme/sahara/sections/testimonials/testimonial-link.png?fit=max&auto=format&n=r8ZuiInWhcXEnvSN&q=85&s=1831e6c8b10e8d86daa7ee5f2e2c2bf6" alt="Testimonial link settings" width="3280" height="2186" data-path="images/theme/sahara/sections/testimonials/testimonial-link.png" />
  </Tab>
</Tabs>

## Best practices

<CardGroup cols={2}>
  <Card title="Authentic content" icon="certificate">
    Use real customer testimonials with permission. Authenticity builds trust more than polished marketing copy.
  </Card>

  <Card title="Optimal count" icon="list-ol">
    Display 3-6 testimonials for best results. Too few lacks credibility, too many reduces impact.
  </Card>

  <Card title="Specific feedback" icon="bullseye">
    Choose testimonials that mention specific products, features, or benefits rather than generic praise.
  </Card>

  <Card title="Timing matters" icon="clock">
    Set autoplay to at least 4-5 seconds for testimonials with 30+ words to ensure readability.
  </Card>

  <Card title="Strategic placement" icon="location-dot">
    Place testimonials near conversion points: product pages, checkout, or below hero sections.
  </Card>

  <Card title="Consistent attribution" icon="user-check">
    Use consistent author format across all testimonials (Name + Year, Name + Location, etc.).
  </Card>

  <Card title="Visual consistency" icon="images">
    If using testimonial images, maintain consistent styling, sizing, and quality across all slides.
  </Card>

  <Card title="Mobile optimization" icon="mobile">
    Consider using "No image" layout for mobile-heavy sites to maximize testimonial readability.
  </Card>
</CardGroup>

## Common use cases

<AccordionGroup>
  <Accordion title="Homepage social proof" icon="house">
    Use 4-5 strong testimonials with "Image right" layout and narrow content width. Set autoplay to 5 seconds. Include product links to drive conversions. Place below hero section or featured products.
  </Accordion>

  <Accordion title="Product page validation" icon="box">
    Display 2-3 testimonials specific to the product with "No image" layout. Use product photos as testimonial images. Link testimonials to full review page. Disable autoplay for reading control.
  </Accordion>

  <Accordion title="Landing page trust builder" icon="shield-check">
    Show 3 testimonials with "Image left" layout and full section width. Use customer photos (with permission) or lifestyle imagery. Add verified customer labels to author names.
  </Accordion>

  <Accordion title="About page credibility" icon="users">
    Use "No image" layout with narrow content width focusing entirely on quotes. Display 4-6 testimonials with longer, detailed feedback. Remove product links for cleaner presentation.
  </Accordion>

  <Accordion title="Campaign-specific reviews" icon="megaphone">
    Select 3-4 testimonials related to specific campaign or collection. Use custom featured image matching campaign theme. Set autoplay to 4 seconds with product links.
  </Accordion>
</AccordionGroup>

## Related sections

<CardGroup cols={2}>
  <Card title="Trust indicators" icon="badge-check" href="/themes/sahara/sections/trust-indicators">
    Display trust badges and guarantees
  </Card>

  <Card title="Product recommendations" icon="star" href="/themes/sahara/sections/product-recommendations">
    Show recommended products based on behavior
  </Card>
</CardGroup>
