Skip to main content
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

ComponentDescription
BoxpressdReviewSummaryDisplays review statistics and average ratings.
BoxpressdRatingBadgeCompact 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

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

<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

import { BoxpressdRatingBadge } from "@boxpressd/sites-sdk"

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

Props

PropTypeDescription
ratingnumberAverage rating value.
reviewCountnumberNumber of reviews.
showReviewCountbooleanDisplay review totals.
size"sm" | "md" | "lg"Badge size.
classNamestringAdditional CSS classes.

Small Badge

<BoxpressdRatingBadge
  rating={4.8}
  reviewCount={82}
  size="sm"
/>

Large Badge

<BoxpressdRatingBadge
  rating={4.9}
  reviewCount={247}
  size="lg"
/>

Review Summary Data

Review summary components typically display data similar to:
{
  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.
<section className="trust-section">
  <h2>Trusted by Cigar Enthusiasts</h2>

  <BoxpressdReviewSummary />
</section>

Example: Venue Card

<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

<BoxpressdReviewSummary />
Displays review information for the venue associated with the API key.

Brand Example

<BoxpressdReviewSummary />
Displays review information for the brand associated with the API key. No additional configuration is required.

Styling

Review components inherit Boxpressd theme variables.
:root {
  --bxp-primary: #d3a966;
  --bxp-border-radius: 16px;
}

Custom Section Styling

<section className="review-section">
  <BoxpressdReviewSummary />
</section>
.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.