WooCommerce: Installing Yotpo Reviews

This guide will walk you through the process of integrating Yotpo Reviews into your WooCommerce store.

Before You Start

• Make sure you have a Yotpo Reviews account. See our plans here.

• Make sure your store meets the requirements: WordPress 6.0 or later, PHP 8.2 or later, and WooCommerce 3.0 or later. The plugin is tested up to WordPress 7.1 and WooCommerce 11.2.

  Note

  From plugin version 2.0.0, the plugin needs PHP 8.2 or later. Stores on an older PHP version aren't offered the update and keep version 1.11.1. If the Yotpo plugin shows a warning about your PHP version, ask your hosting provider to update PHP.

  Check that your store meets the requirements: WordPress 6.0 or later, PHP 7.4 or later, and WooCommerce 3.0 or later. The plugin is tested up to WordPress 7.1 and WooCommerce 11.2.

• Check our Supported Platforms guide.

Note

The plugin doesn't support third-party page builders such as Elementor or Divi. For those, please see our guide on manually installing the Reviews Widget and Star Rating.

Installing Yotpo Reviews

Follow the steps in order and don't skip any.

Note

Changes to on-site widgets, such as the Reviews Widget and Reviews Tab, can take time to appear on your live site. Learn about widget performance settings.

This guide will walk you through the process of integrating Yotpo Reviews into your WooCommerce store.

Step 1: Install the Yotpo plugin

1. In your WordPress admin, go to Plugins > Add New and search for Yotpo Product Reviews. Install and activate the Yotpo plugin.

2. Click Yotpo in the WordPress admin menu.

3. Under Connection, enter your App key and Secret token. New to Yotpo? Click Sign up on yotpo.com, create your account, then come back and enter your keys.
   

4. Under Orders, check that Send orders to Yotpo is on. Then, under Send review requests when an order reaches, choose the status that means an order is fulfilled. The default is Completed, and any order status works, including custom ones such as Delivered. Orders that reach it are sent to Yotpo and trigger automatic review requests (Premium and Enterprise plans).

5. Click Save changes.
   

Note

Once your keys are saved, the plugin starts syncing your product catalog to Yotpo in the background. Jump to Product catalog sync.

Step 2: Enable reviews for your store

This step applies to WooCommerce 3 and later. On older versions, skip to Step 3.

1. In your WordPress admin, go to WooCommerce > Settings > Products.

2. Check Enable product reviews and click Save changes.

Step 3: Choose your on-site widgets

Activating the plugin adds Yotpo's JavaScript, Conversion Tracking, the Reviews Widget, and the Star Rating to your product pages. The Q&A widget is optional (see Q&A Widget Overview).

To choose which widgets appear and where:

1. Click Yotpo in the WordPress admin menu and scroll to On-site widgets.

2. Set Widget placement:

   • Automatic places the widgets in your theme's standard product page areas.

   • Manual lets you place them yourself. Follow the Manual Installation Guide.

3. Turn on the widgets you want: Reviews widget, Star rating on product pages, Star rating on category pages and Q&A widget (optional). For Reviews carousel, Promoted products and Reviews tab, check the pages each one appears on.

4. Leave Match each page's language on to show the widgets in each page's language, including on multilingual sites (WPML, Polylang). Turn it off to use the language set in Yotpo, under Account Settings > General Settings > Language.

5. Click Save changes.
   

   Note

   If you turn on a widget you haven't customized in Yotpo yet, customize it in Yotpo Reviews first. Stores that updated from an earlier plugin version start with Match each page's language off, so their widgets keep the language set in Yotpo.

   Note

   Still on V2 widgets? On-site widgets shows the notice Your store uses V2 widgets, which are being retired. Set up your V3 Reviews Widget in Yotpo, then click Switch to V3 widgets. The plugin turns on the V3 versions of the widgets your store showed. You can't switch back.

Step 4: Import your existing reviews

1. Click Yotpo in the WordPress admin menu and scroll to Tools.

2. Click Export reviews to download your WooCommerce reviews as a CSV file.

   

3. Send the file through the online support form, and we'll import your reviews.

Step 5 (optional): Send past orders

Send orders from before you installed the plugin, so those customers can be asked for a review.

1. Click Yotpo in the WordPress admin menu and scroll to Orders.

2. Under Send past orders, enter how many days back to go, from 1 to 180. The default is 90. The number of orders in that period shows below the button.

3. Click Send past orders and confirm.

The orders are sent in the background, and the progress shows under the button. Only orders in the status you chose in Step 1 are sent. Orders Yotpo already has are skipped, so running it again sends no order twice.

Note

Customers of these orders may get a review request, depending on your Yotpo settings. Learn more in WooCommerce: Setting Up Past Automatic Review Requests.

Step 5 (optional): Send past orders

Under Tools > Send past orders, you can send orders from the last 90 days with the status you chose in Step 1 so Yotpo can ask those customers for reviews. You can do this once. Review requests may go out for these orders, depending on your Yotpo settings.

Learn more in Setting up past automatic review requests.

Product Catalog Sync

Available from plugin version 1.10.0.

The plugin keeps your product catalog in Yotpo up to date, including variations. It runs in the background, so it doesn't slow down your store's pages.

• First sync: right after you connect or update, the plugin syncs your whole catalog once. It checks what Yotpo already has and only sends what's missing or changed.

• After that, each product you add or change syncs on its own.

• Unpublished products: draft, trashed, or deleted products are hidden in Yotpo. They won't receive review requests and won't appear in widgets. Publishing a product again restores it.

• Variations: each variation is synced as a variant of its product. Disabled or deleted variations are marked as discontinued.

• Brand and barcodes: the brand comes from WooCommerce Brands, and barcodes from the product's GTIN, UPC, EAN, or ISBN field. If those are empty, the plugin uses product attributes named brand, upc, isbn or ean. To send an MPN, add a product attribute named mpn.

Sync status

Under Product catalog, the line below Sync products to Yotpo shows what the sync is doing:

Turning the sync off

Under Product catalog, turn off Sync products to Yotpo and click Save changes. Any queued sync jobs are canceled. Turning it back on runs a full sync to catch up.

Order sync

Available from plugin version 2.0.0.

The plugin sends each order to Yotpo once, when it reaches the status under Send review requests when an order reaches. It runs in the background, so checkout stays fast.

• Refunds before the order is sent: a product refunded in full gets no review request. A product refunded in part is still included.

• Refunds after the order is sent: refunding or cancelling the whole order cancels its review requests. A single product refunded later stays in the request.

• Orders sent by earlier plugin versions are found in Yotpo and not sent again.

• Daily check: once a day, the plugin sends orders from the last 7 days that Yotpo is missing, for example after a connection problem.

• Skipped orders: orders without an email address or a first name, and orders placed more than 6 months ago.

Order sync status

The line below Send orders to Yotpo shows how sending is going:

Turning it off

Turn off Send orders to Yotpo only if your orders reach Yotpo another way, then click Save changes. Orders waiting to be sent are canceled. When you turn it back on, orders fulfilled in the meantime aren't sent: use Send past orders for them.

Managing the blocklist, groups and custom questions with product tags

Available from plugin version 1.11.0.

You can set a product's blocklist status, review group, and custom question form with WooCommerce product tags, instead of updating your product catalog in Yotpo.

Turning it on

1. Click Yotpo in the WordPress admin menu and scroll to Product catalog.

2. Turn on Use product tags for the blocklist, groups, and custom questions.

3. Click Save changes. The plugin syncs your catalog once to apply your tags.

Once your keys are saved, the plugin starts syncing your product catalog to Yotpo in the background. Jump to Product catalog sync.

Please note:

When this setting is on, your product tags replace the blocklist, groups and custom question forms set in Yotpo, for example by catalog CSV. Tag your products before you turn it on.

The tags

Rules

• Tags are case-sensitive: write YBlocklist, YGroup_ and YCRF_ exactly as shown.

• The prefix isn't part of the name: YGroup_shirts puts the product in the group shirts.

• One group and one form per product: if a product has more than one YGroup_ or YCRF_ tag, the first in alphabetical order is used.

• Group names use lowercase letters, numbers, - and _up to 100 characters. Other characters are converted: uppercase letters become lowercase, spaces become_, and any other character becomes -.

• Form tags must match the tag of the form exactly, including uppercase and lowercase letters, and can't contain commas.

• Removing a tag reverses it: the product leaves the blocklist or its group, or goes back to the default form.

• Renaming or deleting one of these tags under Products > Tags updates every product that has it.

Please note:

To tag many products at once, select them on the Products page, then choose Bulk actions > Edit and add the tag under Product tags.

Turning it off

Turn off Use product tags for the blocklist, groups, and custom questions, and click Save changes. Products keep the blocklist status, group, and form they have in Yotpo, and you can manage them in Yotpo again.

Changing your app key and secret token

1. Click Yotpo in the WordPress admin menu. Under Connection, click Change keys.

2. Enter the new app key and secret token. To keep your saved secret token, leave its field empty.

3. Click Save changes. The plugin checks the new keys with Yotpo first. If Yotpo doesn't accept them, your saved keys stay.
   

Note:

A different app key connects your store to another Yotpo account. Your product catalog is sent to it again, and new orders go to it. To send it earlier orders, use Send past orders.

Showing more Yotpo widgets (for developers)

If your theme calls wc_yotpo_show_custom_widgets() on product pages, list the widgets it shows with the wc_yotpo_custom_widget_instances filter, for example in your theme's functions.php:

add_filter( 'wc_yotpo_custom_widget_instances', function ( $ids ) {
    $ids[] = '123456'; // The widget's instance ID
    return $ids;
} );

You'll find a widget's instance ID in Yotpo under [path: confirm with Teddy]. From plugin version 2.0.0, wc_yotpo_show_custom_widgets() shows nothing until you add an instance ID.

Troubleshooting

The Reviews Widget doesn't appear on some product pages

1. In your WordPress admin, click Products.

2. Select the products where the widget should appear.

3. Open Bulk actions, choose Edit, and click Apply.

4. Next to Comments, select Allow.

5. Click Update.

Orders don't reach Yotpo

1. Click Yotpo and scroll to Orders. The line below Send orders to Yotpo shows the last failure and its error.

2. Check that your orders reach the status under Send review requests when an order reaches.

3. Orders without an email address or a first name, and orders placed more than 6 months ago, are skipped.

4. To see the background jobs, go to WooCommerce > Status > Scheduled Actions and search for "yotpo".

The plugin shows a warning about your PHP version

Your server runs a PHP version without the fix for two critical security flaws in PHP itself. Ask your hosting provider to update PHP to the version in the warning, or to confirm they've applied the fix.

The sync status shows an error

• HTTP 406: Yotpo rejected a product or image URL. This happens on staging and local sites, such as localhost, whose URLs Yotpo can't reach. Orders with those products fail for the same reason. Run the plugin on your live store.

• To see the sync's background jobs, go to WooCommerce > Status > Scheduled Actions and search for "yotpo".

• For developers: the plugin includes WP-CLI commands: wp yotpo product-sync status, wp yotpo product-sync start and wp yotpo product-sync product <id>.