# Testimonials: Grid/Carousel


Build trust by showing several customer reviews at once, each with the customer's words, name, and an optional photo and product. Show them in rows on one screen, or in a row that customers scroll through.


* **Carousel** — shows reviews in a row that customers can scroll. Best for many short reviews when you want to save vertical space.
* **Grid** — shows reviews in rows. Best for showing many reviews on one screen.
## How to customize the Testimonials: Grid/Carousel section
1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**.
2. Click **Add section**.
3. Select **Testimonials: Carousel** or **Testimonials: Grid**.
4. Click a **Testimonial** block. To add another review, click **Add block** under the section and select **Testimonial**.
5. Click **Select** next to **Image** to add the review photo.
6. Click the **Text** block inside the testimonial to enter the review.
7. Click the **Information** block inside the testimonial to enter the reviewer's name and bio.
8. Repeat steps 4–7 for each review.
9. Click **Save**.
## Section settings
### Layout
Controls how testimonials are arranged on desktop.
| Setting | Description | Options |
| -------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Container** | Controls the width of the section content. | **Full:** Uses the available page width.
**Fixed:** Keeps the content within the theme's fixed container width. |
| **Type** | Determines how testimonials are displayed. | **Grid** or **Carousel**. |
| **Columns** | Sets the number of testimonials displayed per row on larger screens. | **2–8 columns**. |
| **Column gap** | Controls the horizontal spacing between testimonials. | **0–100px**. |
| **Row gap** | Controls the vertical space between rows of testimonials. | **0–100px**.
*Available when **Type** is set to **Grid**.* |
### Mobile layout
Controls how the section appears on mobile devices.
| Setting | Description | Options |
| -------------------------- | --------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |
| **Enable swipe on mobile** | Controls whether customers can swipe horizontally through testimonials on mobile. | **On** or **Off**. |
| **Custom column width** | Lets you manually control the width of each testimonial on mobile. | **On** or **Off**.
*Available when **Enable swipe on mobile** is turned on.* |
| **Custom width** | Sets the width of each testimonial on mobile. | **20–90%**.
*Available when **Custom column width** is turned on.* |
| **Mobile columns** | Sets the number of testimonials displayed per row on mobile. | **1 column** or **2 columns**.
*Available when **Custom column width** is turned off.* |
| **Horizontal gap** | Controls the horizontal space between testimonials on mobile. | **0–100px**. |
| **Vertical gap** | Controls the vertical space between rows of testimonials on mobile. | **0–100px**.
*Available when **Enable swipe on mobile** is turned off.* |
### Appearance
| Setting | Description | Options |
| ---------------- | ----------------------------------------------------------------------------------------------------------------- | :-------------------------------- |
| **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. |
### Padding
Controls the top and bottom spacing separately for desktop and mobile.
| Setting | Description | Options |
| ----------- | ------------------------------------------------------------- | :------------------------- |
| **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. |
| **Top** | Controls the space above the section content. | **0–100px**. |
| **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks
The section includes one **Header** block and multiple **Testimonial** blocks.
### Header
The **Header** block holds the heading content above the testimonials.
| Setting | Description | Options |
| ------------- | ------------------------------------------------------------- | ------------------------------- |
| **Alignment** | Sets the alignment of the header content. | **Left, Center,** or **Right**. |
| **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. |
| **Bottom** | Controls the space below the header. | **0–100px**. |
The default **Header** includes a **Heading** block. To add more, click **Add block** inside the **Header** and select one of these blocks:
* [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the main title of the section.
* [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading.
* [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays additional descriptions or details.
* [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image): Displays an image or icon.
* [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button.
### Testimonial

Each [**Testimonial**](https://docs.foxecom.com/pebble-theme/theme-blocks/testimonial) block shows one customer review, with an optional image and a related product.
| Setting | Description | Options |
| ----------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Design** | Controls the layout of the testimonial. | **Stacked:** Arranges the content vertically.
**Inline:** Places the image and content side by side. |
| **Show image** | Controls whether an image is shown in the testimonial. | **On** or **Off**. |
| **Image** | Sets the image on desktop. | Select or upload an image, or click **Explore free images**. |
| **Image mobile** | Sets a separate image for mobile. | Select or upload an image, or click **Explore free images**. |
| **Aspect ratio** | Controls the image proportions on desktop. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)**. |
| **Aspect ratio mobile** | Controls the image proportions on mobile. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)**. |
| **Keep image away from edge** | Adds space between the image and the outer edge of the testimonial. | **On** or **Off**. |
| **Corner radius** (Image) | Controls how rounded the image corners are. | **0–32px**. |
| **Product** | Selects a product to show with the review. | Select a product from your store. |
| **Inherit color scheme** | Controls whether the testimonial uses the section's color scheme. | **On** or **Off**. |
| **Color scheme** | Sets the color scheme of the testimonial. | Select an available color scheme.
*Available when **Inherit color scheme** is turned off.* |
| **Corner radius** | Controls how rounded the testimonial corners are. | **0–32px**.
*Available when **Inherit color scheme** is turned off.* |
Each **Testimonial** includes two built-in blocks: **Text** and **Information**.
#### Text
The **Text** block shows the review. [*See the **Text block documentation** for all available settings*](https://docs.foxecom.com/pebble-theme/theme-blocks/text).
| Setting | Description | Options |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| **Text** | Sets the review text. To add an animated highlight, wrap the text in italics using the **I** button in the editor. | Enter your text. |
| **Highlight style** | Applies an animated highlight effect to the italic text. | **None, Standard, Wavy underline,** or **Solid background**. |
| **Preset** | Sets the typography style of the review. | Choose a preset style |
| **Color** | Sets the color of the review text. | **Text** or **Subtext**. |
| **Top** | Controls the space above the review. | **0–100px**. |
| **Bottom** | Controls the space below the review. | **0–100px**. |
| **Mobile scale** | Scales the padding on mobile. | **20–100%**. |
| **Type** (Animation) | Sets the entrance animation of the review. | **None, Fade in, Fade up, Slide in (left),** or **Slide in (right)**. |
#### Information
The **Information** block shows who wrote the review.
| Setting | Description | Options |
| ------------------ | ----------------------------------------- | ------------------------------------------------------------ |
| **Image** (Avatar) | Sets the reviewer's avatar. | Select or upload an image, or click **Explore free images**. |
| **Width** | Sets the avatar width on desktop. | **30–100px**. |
| **Width mobile** | Sets the avatar width on mobile. | **30–100px**. |
| **Text** (Name) | Sets the reviewer's name. | Enter your text. |
| **Preset** | Sets the typography style of the name. | **Heading 5** or **Heading 6**. |
| **Icon** | Sets the icon shown next to the bio. | Select an icon, such as **Check circle**. |
| **Text** (Bio) | Sets a short line about the reviewer. | Enter your text, such as **Verified Buyer**. |
| **Color** | Sets the color of the bio. | **Text** or **Subtext**. |
| **Top** | Controls the space above the information. | **0–100px**. |
| **Bottom** | Controls the space below the information. | **0–100px**. |
| **Mobile scale** | Scales the padding on mobile. | **20–100%**. |
Always add a name or identifier, such as **Verified Buyer**, because a named reviewer makes the testimonial more trustworthy.
To remove a review, open its **Testimonial** block and click **Remove block**.
## Tips and best practices
* Show an author name or identifier, such as the customer's name, **Verified Buyer**, an industry expert, or an editor.
* Keep image sizes and padding consistent across testimonials for a clean layout.