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

# About Ratings and Reviews

> [!WARNING]
>
> This feature is in **beta**. This means it might at any time be changed, withdrawn from your account, or become part of a paid add-on module. You might also experience interruptions of this service, degradation of user experience or faulty behavior even in critical processes such as automations and sendouts. Voyado welcomes feedback on beta features, and encourages you to try them, but you should *not* build business critical logic on beta features. Only when a feature reaches its full release can you trust it to function reliably with no further breaking changes.

Ratings and Reviews is a Customer Engagement feature that lets your customers submit and view product ratings and reviews directly on your storefront. These articles cover:

* How to add ratings and reviews widgets using Voyado's JavaScript SDK
* Single Page Application handling
* CSS custom properties for further customization

## Environments

Voyado provides you with two isolated environments. Each has its own script URL, backend, and data store meaning that nothing is shared between them.

| Environment | Script URL | Purpose |
| :- | :- | :- |
| Staging | `https://static.staging.onsite.voyado.com/widget/voyado.js` | Connected to your staging Voyado environment. Use for integration, testing, and QA. |
| Production | `https://static.onsite.voyado.com/widget/voyado.js` | Connected to your production Voyado environment. Live, customer-facing. |

> [!TIP]
>
> Always integrate and verify in the Staging environment first. Once the setup is confirmed to work there, switch to the Production URL for your go-live.

## Setting up

The basic steps to get ratings and reviews on your site are:

1. **Include the script** — Load the `voyado.js` script via GTM or a `<script>` tag
2. **Add HTML containers** — Place `<div>` elements with the right CSS class and `data-product-id` where you want widgets
3. **Call `load-widgets`** — Tell the SDK which widget types to render

> [!TIP]
>
> Most customers load the `voyado.js` script through Google Tag Manager. Doing it this way keeps the script out of your codebase and lets you manage configuration, user identity, and widget loading entirely via GTM tags. This is the recommended way to load the script.

In the "Integrate Ratings and Reviews" articles the steps above will be examined in more detail.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.