# Testimonials Grid

> Render testimonial cards with author metadata and ratings.

Canonical HTML: https://press.varavel.com/docs/shortcodes/testimonials-grid/
Markdown: https://press.varavel.com/docs/shortcodes/testimonials-grid/index.md

`testimonials_grid` renders quotes in bordered cards with optional avatar, role, company, and star rating.

## When to Use

Use it when customer proof helps reduce risk. Keep quotes specific and tied to outcomes rather than generic praise.

## Usage

```markdown
{{/* testimonials_grid(
item_1_quote="VaraPress made our launch page simple to ship.",
item_1_name="Ada Lovelace",
item_1_role="Engineer"
) */}}
```

## Live Example

{{ testimonials_grid(
container="md",
title="What builders say",
item_1_quote="VaraPress made our launch page simple to ship.",
item_1_name="Ada Lovelace",
item_1_role="Engineer",
item_1_rating="5",
item_2_quote="The docs and landing sections feel like one coherent system.",
item_2_name="Grace Hopper",
item_2_role="Maintainer",
item_2_rating="5"
) }}

## Parameters

| Parameter        | Description                                       |
| ---------------- | ------------------------------------------------- |
| `container`      | Inner content width for the testimonials section. |
| `eyebrow`        | Small uppercase label above the heading.          |
| `title`          | Section heading.                                  |
| `description`    | Supporting copy below the heading.                |
| `columns`        | Desktop column count. Use `2` or `3`.             |
| `item_N_quote`   | Quote text for testimonial `N`.                   |
| `item_N_name`    | Author name for testimonial `N`.                  |
| `item_N_role`    | Optional author role for testimonial `N`.         |
| `item_N_company` | Optional company name for testimonial `N`.        |
| `item_N_avatar`  | Optional avatar image URL for testimonial `N`.    |
| `item_N_rating`  | Optional star rating from `1` to `5`.             |
| `bg`             | Full-width section background token.              |
| `class`          | Additional CSS classes on the outer section.      |