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

# Reviews

> Display Boxpressd ratings and review information on your website.

Reviews are one of the most effective forms of social proof for lounges, brands, and retailers.

The Boxpressd Sites SDK provides components that make it easy to display ratings, review counts, and customer feedback throughout your website.

All review components automatically use the business context resolved by the `BoxpressdProvider`.

## Available Components

| Component | Description |
| - | - |
| `BoxpressdReviewSummary` | Displays review statistics and average ratings. |
| `BoxpressdRatingBadge` | Compact rating display suitable for cards and listings. |

## BoxpressdReviewSummary

The review summary component displays an overview of a business's review performance.

Typical information includes:

* Average rating
* Total reviews
* Rating distribution
* Recommendation percentage (when available)

### Example

```tsx id="rv3t0m" theme={null}
import { BoxpressdReviewSummary } from "@boxpressd/sites-sdk/reviews"

export default function ReviewsSection() {
  return (
    <BoxpressdReviewSummary />
  )
}
```

### Common Use Cases

* Homepage trust sections
* About pages
* Membership pages
* Landing pages
* Review-focused sections

### Example: Homepage Section

```tsx id="o2q9nk" theme={null}
<section>
  <h2>Trusted by the Community</h2>

  <BoxpressdReviewSummary />
</section>
```

## BoxpressdRatingBadge

The rating badge provides a compact way to display ratings in cards, grids, and content blocks.

### Example

```tsx id="zv9j9g" theme={null}
import { BoxpressdRatingBadge } from "@boxpressd/sites-sdk"

export default function VenueCard() {
  return (
    <BoxpressdRatingBadge
      rating={4.9}
      reviewCount={247}
    />
  )
}
```

### Props

| Prop | Type | Description |
| - | - | - |
| `rating` | `number` | Average rating value. |
| `reviewCount` | `number` | Number of reviews. |
| `showReviewCount` | `boolean` | Display review totals. |
| `size` | `"sm" \| "md" \| "lg"` | Badge size. |
| `className` | `string` | Additional CSS classes. |

### Small Badge

```tsx id="fw8wxg" theme={null}
<BoxpressdRatingBadge
  rating={4.8}
  reviewCount={82}
  size="sm"
/>
```

### Large Badge

```tsx id="r1ik2i" theme={null}
<BoxpressdRatingBadge
  rating={4.9}
  reviewCount={247}
  size="lg"
/>
```

## Review Summary Data

Review summary components typically display data similar to:

```ts id="v2c0bn" theme={null}
{
  averageRating: 4.9,
  reviewCount: 247,
  recommendationPercentage: 97
}
```

The exact values available may vary based on the business type and data available within Boxpressd.

## Example: Trust Section

One of the most common implementations is a trust section on a homepage.

```tsx id="i5n3bk" theme={null}
<section className="trust-section">
  <h2>Trusted by Cigar Enthusiasts</h2>

  <BoxpressdReviewSummary />
</section>
```

## Example: Venue Card

```tsx id="1c5gh8" theme={null}
<BoxpressdCard>
  <h3>Stogies Cigar Lounge & Tap House</h3>

  <BoxpressdRatingBadge
    rating={4.9}
    reviewCount={247}
  />
</BoxpressdCard>
```

## Business Awareness

Review components automatically adapt to the active business context.

### Venue Example

```tsx id="op7zkg" theme={null}
<BoxpressdReviewSummary />
```

Displays review information for the venue associated with the API key.

### Brand Example

```tsx id="xyvlyp" theme={null}
<BoxpressdReviewSummary />
```

Displays review information for the brand associated with the API key.

No additional configuration is required.

## Styling

Review components inherit Boxpressd theme variables.

```css id="yzibxg" theme={null}
:root {
  --bxp-primary: #d3a966;
  --bxp-border-radius: 16px;
}
```

### Custom Section Styling

```tsx id="y6hzt8" theme={null}
<section className="review-section">
  <BoxpressdReviewSummary />
</section>
```

```css id="99n7f4" theme={null}
.review-section {
  --bxp-primary: #d3a966;
}
```

## SEO Benefits

Displaying review information can help visitors quickly evaluate your business.

Review components are commonly used to:

* Increase visitor trust
* Highlight customer satisfaction
* Improve conversion rates
* Reinforce brand credibility

When paired with proper structured data, review information may also contribute to enhanced search engine visibility.

## Best Practices

### Display Reviews Near Conversion Actions

Place ratings close to:

* Contact forms
* Membership signups
* Event registrations
* Reservation buttons
* Product links

### Use Review Summaries Prominently

Review summaries work especially well:

* On homepages
* Above the fold
* In hero sections
* Near calls-to-action

### Keep Rating Badges Consistent

Use the same badge style throughout your website for a cohesive experience.

## Future Components

Additional review-related components planned for future releases include:

* Review feeds
* Individual review cards
* Review carousels
* Featured review widgets
* Testimonial sections
* Structured review markup helpers

## Next Steps

Continue to:

* Maps
* Check-ins
* Sessions
* Data Fetching

These guides cover additional business data and customer engagement components.