# Product reviews for WooCommerce

> Connect WooCommerce to Reytd with our free plugin: products and orders sync by themselves, review requests go out after shipping, and the reviews show on product pages.

The Reytd Reviews for WooCommerce plugin connects your WooCommerce shop to Reytd. Once it's connected, your products, orders and shipments go to Reytd by themselves, each customer is asked for a review after their order ships, and the reviews show on your product pages, in place of WooCommerce's own.

It's free, from the [WordPress plugin directory](https://wordpress.org/plugins/reytd-reviews-for-woocommerce/), and works with block themes and classic themes alike.

## What you need

- **WordPress 7.0** or later, **WooCommerce 10.0** or later, and **PHP 8.1** or later.
- **A Reytd store.** [Start free](https://reytd.com/register): the Free plan sends up to 100 review requests a month.

## Install and connect

1. **Install the plugin.** In WordPress, go to **Plugins › Add New Plugin**, search for _Reytd Reviews for WooCommerce_, then **Install Now** and **Activate**.
2. **Create a token in Reytd.** Under **Developer › API tokens**, create a **Live** token that can send products and orders (`products:write` and `orders:write`).
3. **Connect.** In WordPress, go to **WooCommerce › Settings › Reytd**, paste the token and click **Connect**. The page shows the store it connected to.
4. **Turn on review requests in Reytd,** under **Review requests**: add a reply-to address there, then switch them on. They start switched off, and only orders that ship after you turn them on get one, so connecting never emails your past customers.

The first sync starts as soon as you connect: every published product, then the paid orders of the last 30 days with their shipments. Its progress shows on the plugin's settings page.

To try it on a staging copy of your shop first, connect with a **Sandbox** token (`rytd_test_…`) instead: everything goes to your store's sandbox, whose emails are simulated, and the widgets show the sandbox's reviews.

## What the plugin sends

- **Products:** each published product's name, SKU, link and image. A variable product is one product in Reytd: reviews are about the T-shirt, not one size or colour.
- **Orders:** once an order is paid or on hold, its number and date, the customer's email address and name, the language they shopped in, and the products they bought. Changes after that are sent too: a refunded item isn't asked about, and a cancelled, refunded or failed order gets no review request.
- **Shipments:** which products shipped and when, with the carrier, tracking number and tracking link when the order has them.
- **Returns:** which products were refunded, and when (see [Refunds and returns](#refunds-and-returns)).
- **Never:** prices, payment details, addresses or phone numbers.

Everything is sent in the background, with WooCommerce's own job queue (**Tools › Scheduled Actions**, group `reytd`). Nothing waits on Reytd while a customer checks out, and anything Reytd couldn't take is retried, then listed on the plugin's settings page and in **WooCommerce › Status › Logs** under `reytd`.

## When an order counts as shipped

A review request starts when an order ships, so the plugin tells Reytd about each shipment. It uses the first of these your shop has:

1. **WooCommerce's own fulfillments,** when you've switched them on: each fulfilled one, with its items and tracking.
2. **The Shipment Tracking or Advanced Shipment Tracking plugin:** the first tracking number added ships the order, with its carrier and link.
3. **Otherwise, completing the order.** An order of only virtual or downloadable products counts as delivered at once.

Reytd then asks for the review 14 days after shipping by default; you can change the wait in Reytd under **Review requests**.

## Refunds and returns

A customer who got their money back for a product shouldn't get an email asking how they like it. So from version 1.1.0, the plugin sends refunded products to Reytd as returns, and Reytd leaves them out of the review request. When in doubt, Reytd doesn't ask: one review too few is better than one email too many.

- **A refund that lists products** is a return of those products, whether the order had shipped or not, and whether the customer sent them back or kept them.
- **A product's money refunded without a quantity** counts as that whole line returned.
- **A refund of an amount only,** or of shipping or a fee, isn't a return: the products are still asked about.
- **A whole order refunded** is cancelled in Reytd: no review request at all.
- **A refund you delete in WooCommerce** brings its products back, so they can be asked about again, if the review request hasn't ended yet.
- **If a return can't be sent** (Reytd refuses it, or can't be reached through about four hours of retries), the order's review request is cancelled, and the plugin's settings page says why.

The rest of the order goes on as usual: a customer who returned one product of three is still asked about the other two. On the order screen, a line under **Refunded** says how the refund counts.

**Returns plugins.** Any returns plugin that pays the customer back through a WooCommerce refund works by itself. Returns that don't end in a refund, such as store credit or an exchange, aren't seen.

**Sending returns of your own.** A developer can send a return from a warehouse system or another returns tool, and the plugin queues it like a refund's:

```php
// The order, the return's own id, when it was returned, and quantities by the order's item id.
do_action( 'reytd_send_return', $order_id, 'rma-1042', '2026-11-21 14:00', [ $item_id => 1 ] );

// Withdrawn or declined later: the same, with when as a fifth argument.
do_action( 'reytd_send_return', $order_id, 'rma-1042', '2026-11-21 14:00', [ $item_id => 1 ], '2026-11-22 09:00' );
```

A return that doesn't add up (an item that isn't in the order, more than was ordered) is left out and listed on the plugin's settings page.

## The reviews on your shop

The plugin puts the widgets on your product pages and hides WooCommerce's own stars and Reviews tab. To keep WooCommerce's showing as well, turn off **Show Reytd's reviews and stars in place of WooCommerce's own** under **WooCommerce › Settings › Reytd › Widgets**.

- **Block themes** (Twenty Twenty-Five and other themes edited in the Site Editor): the _Reytd stars_ block goes after the product's rating and the _Reytd reviews_ block after its details, in the single product template. Move or remove them in **Appearance › Editor**, and add a _Reytd carousel_ block to any page.
- **Classic themes** (such as Storefront): the stars go under the product's title and the reviews in the Reviews tab. Under **WooCommerce › Settings › Reytd › Widgets** you can put the reviews after the product's summary instead, or nowhere, to place them yourself.
- **Shortcodes,** for page builders or anywhere else: `[reytd_stars]`, `[reytd_reviews]` and `[reytd_carousel]`. On a product page they show that product; elsewhere, name it with its WooCommerce ID: `[reytd_reviews product="123"]`.

(Growth and up) A carousel without a product shows your store's best recent reviews. Carousels are on the Growth and Pro plans.

The widgets are the same as on any other site: see [Add review widgets to your store](https://reytd.com/docs/widgets.md) for how they look and what they do.

## Your privacy policy

The plugin suggests text for your privacy policy, under **Settings › Privacy › Policy Guide** in WordPress: what it sends to Reytd and why. See [Customer data and GDPR](https://reytd.com/docs/integrations/privacy.md) for where Reytd keeps it.

## If something doesn't work

- **No review requests go out.** Check they're turned on in Reytd (they need a reply-to address first), and that the order has shipped: a fulfillment, a tracking number, or the order completed. Only orders shipped after review requests were turned on get one, and the waiting ones are listed under **Review requests** in Reytd.
- **The settings page says _Connection broken_.** Reytd no longer accepts the token, for example because it was deleted in Reytd. Create a new one and paste it there.
- **A widget shows nothing.** The stars and the carousel stay empty until a product has a review. If your site has a Content Security Policy, allow Reytd's addresses: see [If a widget shows nothing](https://reytd.com/docs/widgets.md#if-a-widget-shows-nothing).
- **Your reviews from before Reytd.** Reviews already in WooCommerce aren't copied to Reytd.

## Disconnect

Click **Disconnect** under **WooCommerce › Settings › Reytd**. The plugin stops sending, and its waiting jobs are cancelled. Delete the token in Reytd under **Developer › API tokens** as well. Uninstalling the plugin removes everything it kept in WordPress.

## Next

- [Add review widgets to your store](https://reytd.com/docs/widgets.md): the star rating badge, the reviews widget and review carousels.
- [How to get star ratings in Google search results](https://reytd.com/docs/widgets/google-stars.md).
- [Customer data and GDPR](https://reytd.com/docs/integrations/privacy.md).
