First-party reviews collected through Review Generation can be published on your website to build brand trust and improve click-through rates. Search engines crawl published reviews and use structured data like aggregate ratings and review counts to display rich snippets in search results. This article covers the options for publishing reviews and schema markup best practices.
Publishing Options
Reviews Widget
The Reviews Widget is a snippet of HTML that displays first-party reviews, star ratings, and review counts on your website. It includes built-in schema markup following Google's best practices.
To create a Reviews Widget:
- Navigate to Knowledge Graph > Widgets.
- Click Create a Reviews widget.
- Select the entity you want to create a widget for.
- Toggle whether to include a tracking pixel under Manage your tracking pixel.
- Select a color scheme under Choose your theme. Click Advanced to customize colors, fonts, and sizing further.
- Configure your display settings:
- Show Header: displays the average star rating and total review count
- Leave a Review Link: adds a link for customers to leave a review
- Include Schema: adds schema markup to the widget. Keep this enabled unless you are using Body navigation.
- Show Body: displays the full content of individual reviews
- Show Publisher Icons: displays the icon of the publisher each review came from
- Show Footer: displays the average rating and review count for up to three third-party publishers
- Select your installation method and add the widget to your website.
For accounts with multiple locations: the widget is unique per entity. To dynamically serve the correct widget for each location page, add ?storeCode= followed by the Store ID to the end of your embed code. For example: <script type="text/javascript" src="//sites.yext.com/194152-reviews.js?storeCode=1234567"></script>
Note: Reviews Widgets are only available with the Ultimate package or the Review Generation add-on.
Custom Integration
For more control over how reviews are displayed, build a custom integration using the Yext API or work with Yext Professional Services. See the Yext Reviews API documentation for details.
Schema Markup Best Practices
If you build a custom integration, schema markup is not included automatically. Mark up your reviews with structured data so search engines can find and display your review data in search results.
Key schema types to implement:
- AggregateRating: marks up your average star rating and total review count
- Review: marks up individual review content
Useful references: