Reviews for WooCommerce by WpExperts Hub

1. Overview

Reviews for WooCommerce by WpExperts Hub asks your customers for product reviews at the right moment, reminds them politely, lets them write a review on a clean private page without an account, publishes it with a Verified Buyer label after you approve it, and shows your reviews on the product page with a rating summary, customer photos, filters and helpful votes.

When an order becomes Completed the plugin emails the billing address a review request with five clickable stars and a button for every product that was bought. Products that still have no review get a reminder 5 days later and a final reminder 7 days after that. Before every email the plugin checks again, so nobody is asked about something they already reviewed, and every email has a one-click Stop review emails link.

Customers with an account also find a Leave a review button on their orders in My Account → Orders and a Your reviews list on every order page. The button opens the same private review page as the email.

On the product page the plain review list becomes a reviews section: the average rating with a bar per star level, a strip of customer photos, filters, sorting, Was this helpful? votes and Show more reviews. You can thank every reviewer with a personal coupon, whatever their rating, tell them when their review is live or when you replied, and get an alert for low ratings.

How it works

1. An order is completed. The plugin records the order, lists the products that can be reviewed and schedules the initial email (immediately, or after the delay you set). The sequence starts once per order: going from Completed to another status and back never restarts it.
2. The emails go out from a background queue. Action Scheduler (part of WooCommerce) runs the jobs, with WP-Cron as a fallback. Each email is claimed with an atomic step, so a repeated status change, a retried job or a double click can never send the same email twice.
3. The customer writes a review. A star in the email, the button under a product, or the Leave a review button on the order in My Account opens a private page with a star rating, optional title, text and optional photos. The link contains a random token that expires; it shows nothing about the order to anyone without it.
4. You moderate it. The review is saved as a normal Pending WooCommerce product review. You approve, reject or trash it in the usual place. Approved reviews of a real purchase show a Verified Buyer label, and the customer gets a Review published email (with the thank-you coupon, if you use them).
5. Reminders stop by themselves. As soon as every product of the order has a review, or the customer unsubscribes, the remaining reminders are cancelled. A reminder only ever lists the products that still wait for a review.
6. Shoppers see it. The review appears in the reviews section of the product page, with photos, the Verified Buyer label and helpful votes, and counts in the rating summary and in Insights.

At a glance

What it does not do

• It does not publish reviews on its own. Reviews are Pending until you approve them, unless you switch on automatic approval.
• It does not reward only good reviews. A thank-you coupon never depends on the rating: rewarding only positive reviews is not allowed by Google, the FTC and EU consumer law.
• It does not email anyone who unsubscribed, neither automatically nor from a bulk action or a manual send.
• It does not prove delivery. WordPress can only report that it handed an email to the mail system. The log says exactly that and never claims an email was delivered or opened.
• It does not import reviews from other sites or services, and it does not send review requests for orders that are not in an eligible status.
• It does not replace WooCommerce reviews. Reviews are ordinary WooCommerce product reviews, so they keep working if you deactivate the plugin.

2. Requirements

3. Installation

1. Download the plugin zip from your account on wpexpertshub.com.
2. In WordPress open Plugins → Add New → Upload Plugin, choose the zip and press Install Now.
3. Activate the plugin. It creates five small tables and adds WooCommerce → Review Requests.
4. Open Review Requests → Settings and check the eligible order statuses and the reminder timing.
5. Open WooCommerce → Settings → Emails and read the seven emails of the plugin (three review requests, three answers to a review and the low rating alert). Send yourself a test email from Settings → Email.
6. Open a product with reviews and look at the reviews section in your theme. Settings → Product page switches its parts, or the whole section, off.
7. Activate your licence under Plugins → WpExperts Hub Licences to receive updates.

Licence and updates

Open Plugins → WpExperts Hub Licences, enter your licence key and the email address used for the purchase, and press Activate. The licence is only used for updates: every feature works without it.

The licence and update check contacts wpexpertshub.com with the licence key, your site address and the plugin version. It never sends orders, customers, emails or reviews.

What activation creates

Updating, deactivating and deleting

• Updating keeps your settings and records. The tables are upgraded automatically when needed (1.3.0 adds the unsubscribe and vote tables).
• Deactivating pauses the queue and deletes nothing. When you activate again, missing queue jobs are re-created. The reviews stay on your product pages in your theme's own layout.
• Deleting the plugin removes its data only if Delete all plugin data on uninstall is on (Settings → Data & privacy), including the queued emails. Reviews are WooCommerce reviews and thank-you coupons are WooCommerce coupons: neither is ever deleted.

Multisite

Each site of a network has its own tables, settings and queue. Network activation creates the tables on every site, and on sites created later.

4. Quick start

Five minutes to your first review requests:

1. Check the basics. Review Requests → Settings → General: Automatic review requests is on and Completed is ticked under eligible order statuses. That is the default.
2. Look at the review page. Settings → Review form → Preview the review page shows it with your latest products. Pick a Review page colour if your email colour does not suit it.
3. Look at the emails. Settings → Email shows the timing (5 and 7 days by default), the stars and your logo. Press Preview next to an email, then send yourself a test email.
4. Look at a product page. Open a product that has reviews: the reviews section shows the summary, the photos and the filters. Settings → Product page sets the order and the number of reviews per page.
5. Optional: thank reviewers. Settings → Rewards → Thank-you coupon: a personal coupon for every review, sent when you approve it.
6. Complete an order. Mark a test order Completed. It appears under Review Requests with its initial email scheduled. Open Details and press Send now if you do not want to wait.
7. Write a review. Open the link from the email, rate the product and submit. The review is Pending. Or sign in as a customer with a completed order and press Leave a review in My Account → Orders.
8. Approve it. Products → Reviews (or Comments): approve the review. It appears on the product page with a Verified Buyer label, and the customer gets the Review published email.
9. Ask for older orders too. On WooCommerce → Orders select completed orders and choose Review request: send initial email from Bulk actions.

5. Features

The review sequence

• Once per order. The sequence of an order starts once. Completed → On hold → Completed does not start it again. An administrator can reset it from the order's detail screen.
• A disabled email is skipped, not stuck. If you switch an email off in WooCommerce, that step is marked skipped and the next one is planned from the same moment.
• Rechecked before every send. The order status, refunds and existing reviews are checked at the moment of sending. A product that was reviewed in the meantime, by any route, is never emailed.
• Cancelled automatically. If the order becomes cancelled, refunded or failed, the waiting emails are cancelled (setting Skip refunded, cancelled and failed orders). A completely refunded product is always skipped, and you choose whether a partial refund stops the sequence.
• Retries. If WordPress cannot hand an email to the mail system, the plugin tries again after 15, 30 and 45 minutes, then marks the email Failed with the error text. Each attempt is logged once.
• Unsubscribed means unsubscribed. When the customer uses Stop review emails, the waiting emails of all their orders are cancelled, and no later order, bulk action or manual send emails that address again.

Who is asked, and for what

An order is asked when it has a valid billing email address, an eligible status and passes your rules. Each product is checked on its own.

The emails

• Native WooCommerce emails. All seven emails are registered under WooCommerce → Settings → Emails, so enabling, subject, heading, additional content and HTML or plain text work like any other WooCommerce email, with WooCommerce's live preview. Each answer email is sent once per review or reply, however often a review is moderated back and forth.
• Stars in the email. Five clickable stars under every product. A click opens the review page with that rating chosen; nothing is saved until the customer sends the review. Switch them off with Stars in the email.
• Stop review emails. Every request and reminder has an unsubscribe link and the one-click unsubscribe header (RFC 8058) that Gmail, Yahoo and Outlook show as their own Unsubscribe button. See Unsubscribe.
• Placeholders for subject and heading: {site_title}, {order_number}, {order_date} and {customer_first_name}.
• Branding. Choose an email logo and the sender name and address in Review Requests → Settings → Email, and whether product images and prices appear.
• Built for mail clients. Table-based layout with inline styles, a bulletproof button, no JavaScript and a plain-text version, readable on phones.
• Theme overrides. Copy any template of templates/emails/ (and its plain version) to yourtheme/woocommerce/emails/. See Template overrides.
• Preview and test. A preview with sample data, and a test email to any address. Neither creates a record.
• No attachments. Review emails never carry attachments, even when an invoice or packing-slip plugin adds PDFs to customer emails.

The review page

• No account needed. The link is the key. You can require customers who have an account to sign in first (Sign-in requirement); guest orders never need one.
• Several products, one page. The order number and date, and for several products a progress bar ("1 of 3 products reviewed"). Products still to review come first; the one from the button that was pressed is at the top. Reviewed products show the review with its stars and status.
• Fields. Star rating (required or not) with words such as Good or Excellent, name, the billing email (read-only, never shown publicly), optional title, review text with a counter and the minimum length, and optional photos. A star clicked in the email is already selected.
• How the name is shown. The customer chooses Maya Collins, Maya C. or Maya (setting Name display choice). The choice applies on the product page, in the slider and in emails; in the admin you always see the full name.
• The coupon offer. When thank-you coupons are on, the page says what the customer gets, "whatever your rating", and after sending shows the code or says when it will arrive.
• Photos. Previews before sending, with a remove button per photo. JPG, PNG, GIF and WebP only, checked by content on the server and not just by file name, with a maximum number and size per image.
• Friendly errors. The page checks the rating, name, length and photos before sending, so a photo is not lost to an avoidable mistake; the server checks everything again. If something is wrong the customer sees what to fix and keeps everything they typed.
• Thank-you and edit. After submitting the customer sees a thank-you and a link to the next product; when everything is reviewed, a thank-you card with Back to your order and Continue shopping. Refreshing the page cannot create a second review. If you allow it, Edit your review opens the form again until you moderate it.
• Your colours. Buttons, links and highlights use Review page colour (Settings → Review form), or your WooCommerce email base colour when it is empty, with white or dark text chosen for contrast. Your email logo is shown at the top.
• Accessible and private. Real labels, keyboard-friendly star radios in reading order, visible focus, good contrast, dark mode, a phone layout. The page is not indexed, sends no referrer and is never cached.

Leave a review in My Account

• Where it appears. Next to View in My Account → Orders, and with the order actions on the order page. It is a normal WooCommerce order action, so it appears in any theme without template changes. Themes that give the Actions column room for one button only get a little more room on pages that show it.
• When. For the signed-in customer of the order, when the order is in an eligible status and at least one product can still be reviewed. Reviewed, refunded and excluded products are not offered. Never on the thank-you page right after checkout.
• What it opens. The same private review page as the email, with Back to your order at the top. An older order without a review request gets one at that moment (no email is sent because of it), and an expired link is renewed.
• Safe to share by accident. The button carries the order number and a security code that expires within a day (a nonce), never the review link. Only the signed-in customer of that order gets through; anyone else is sent back to their own orders.
• Your reviews on the order page. Under the order details, every product of the order with its status (Not reviewed yet, Awaiting approval, Published), its stars, a Write a review button or a link to the published review.
• Settings. Review Requests → Settings → My Account: switch the button and the list on or off, and change the button text.

Review links and security

• Random and unguessable. A link carries a random selector and a signature derived from your site's secret keys. A copy of the database alone cannot produce a working link, and the order number is not in the link.
• They expire. Links expire after the number of days you set, counted from the last email sent (60 by default). An expired link shows a plain message and nothing about the order. A daily job permanently revokes links that expired long ago.
• Only what was bought. The page and the form only ever accept products that belong to the order behind the link. The product in the URL only chooses which product is shown first.
• Spam protection. A WordPress nonce on every form, a hidden honeypot field, and rate limits per address and link. A nonce alone is never treated as authorisation.
• One review per product. Duplicate prevention is atomic, so two parallel submissions cannot both succeed. You can choose one review per product and order, or one per customer and product across orders.
• Sharing a link yourself. The order's detail screen shows the customer's link with Copy link, for example to send it in a chat, and Renew link makes an expired link work again for the number of days you set.

Reviews, moderation and Verified Buyer

• Native reviews. A submitted review is a normal WooCommerce product review. It is Pending by default, and you approve, reject or trash it in Products → Reviews or Comments. The request status follows what you do there.
• Automatic approval is off by default. You can switch it on in Settings → Review form.
• What makes a review verified. The review gets WooCommerce's own verified-owner flag only when the order exists, is paid, contains the product on a line that is not completely refunded, and has the same billing email as the review. A guest is never marked verified just because an email matches.
• The label. Show a Verified Buyer badge, WooCommerce's own "(verified owner)" text, or nothing. It is shown in the reviews section, and through WooCommerce's review hooks in your theme's review list when you switch the section off.
• Titles and photos are shown with the review text on the product page.

Reviews on the product page

• Where. In the Reviews tab of the product page, in place of the theme's review list. WooCommerce's own review form stays below it, and Write a review scrolls to it. With the shortcode or block it can be placed on any page.
• Rating summary. The average, the number of reviews and a bar for each star level. A click on a bar shows only those reviews.
• Customer photos. A strip of every photo from the reviews (swipe on phones), and a full-screen viewer with previous and next and a link to the review the photo belongs to.
• Filters and sorting. All reviews, With photos, Verified buyers and the star bars; sort by newest, highest, lowest or most helpful. Show more reviews loads the next ones without reloading the page.
• Was this helpful? Yes and No under every review: one vote per visitor and review (signed-in customers by account, guests by a cookie), never on one's own review, with a limit per address against scripted voting.
• Replies. Approved replies are shown under the review they answer.
• Long reviews are folded behind Read more. Reviewer pictures are initials in a coloured circle by default; Gravatar is a choice.
• Theme-proof and light. The styles are scoped to the section, follow the review page colour and work from phone to desktop. Its files load only on pages that show the section, a slider or a badge.

Thank-you coupons

• Off by default. Switch it on in Settings → Rewards.
• Every review counts. The coupon never depends on the rating. Rewarding only good reviews is not allowed by Google, the FTC and EU consumer law, and the review page says "whatever your rating".
• When. When the review is approved (recommended: spam and empty reviews never earn one), or as soon as it is sent. One coupon per order or one per reviewed product, for any review or only reviews with a photo.
• What. A percentage or a fixed amount, a minimum spend, an expiry, your code prefix (THANKS-7KQ4MZP2), individual use and sale items as you choose. Each coupon is single use and works only with the billing email of the order.
• Only customers' own reviews. Reviews written on the review page or from My Account earn a coupon; a review you add for a customer never does. A coupon is created once per order (or product), even if a review is approved twice.
• Disclosure. Mark rewarded reviews shows "Received a thank-you coupon for reviewing" under those reviews, as consumer-protection rules recommend for incentivised reviews.
• Where to see them. The code is in the email and on the review page, an order note records it, and the Rewards tab lists the latest coupons with their order and whether they were used. The coupons are normal WooCommerce coupons.

Answers to a review

• Review published. When you approve a review written with the plugin, the customer hears that it is live, with a link to it, the coupon if one was earned, and the other products of the order that still wait for a review.
• Reply to a review. Reply to a review in Products → Reviews and the reviewer receives your reply with their review. Only replies of the shop's staff are sent.
• Low rating alert. You hear about a 1 or 2-star review (or 3, as you choose) the moment it is written, with the customer, the order and buttons to reply or moderate. Choose who receives it in WooCommerce → Settings → Emails.

Unsubscribe

• Link and header. Every request and reminder has a Stop review emails link and the List-Unsubscribe / List-Unsubscribe-Post headers (RFC 8058), which Gmail, Yahoo and Outlook show as their own Unsubscribe button. Large mailbox providers expect them from senders. Setting: Unsubscribe link (on).
• What it stops. Review requests and reminders to that address, from any order, also from bulk actions and manual sends. Answers to the customer's own review, your replies and the coupon are still sent, and order emails are not affected.
• The list. Review Requests → Unsubscribed shows the addresses masked (m***a@example.com), how and when they unsubscribed, and lets you add, find or remove one. The list stores a one-way code of each address, so it cannot be read back as a mailing list.

Shortcodes and blocks

In the block editor search for "reviews": the three blocks show a live preview. The same list, with copy buttons, is under Settings → Product page.

Insights

• Key numbers of the shop rating, review emails and reviews in the last 12 weeks, and unsubscribed addresses.
• Emails and reviews per week for 12 weeks, as a chart with the numbers in a table below it.
• Which email worked. For the request, the first and the final reminder: emails sent, reviews written after it and the share of orders that reviewed after receiving it; plus the reviews written from the My Account button. Reviews written before 1.3.0 are counted separately, because the email was not recorded then.
• Rating distribution of all approved product reviews of the shop.
• Ratings per product. Average rating, reviews (with photos), 1–2 star reviews, reviews awaiting approval, the review rate of the requests and the newest review; sortable, searchable and with a Below 3 stars view.

Managing requests

• Dashboard. What needs your attention (reviews waiting for approval, emails that could not be sent), four key numbers (reviews collected, review rate, average rating, emails sent), filters (waiting, awaiting approval, fully reviewed, email failed, cancelled), search by order number, name or email, sortable columns and 20 requests per page.
• The three emails at a glance. Each row shows the request, the reminder and the final reminder as a small track (sent, planned, failed, cancelled) with what comes next or what was sent last.
• A status for every product. Waiting, Awaiting approval, Approved, Rejected, plus an overall status for the order: Not Requested, Scheduled, Email Sent, Reminder Scheduled, Partially Reviewed, Submitted — Awaiting Approval, Review Approved, Completed, Email Failed, Unsubscribed, Cancelled.
• Order detail. The customer, the review status, the next email, every product with its review, the customer's review link with Copy link and Renew link, and the three emails as a timeline with Send now or Send again, Reschedule, Cancel pending reminders, Retry failed emails and Reset sequence.
• Resending needs a confirmation. An email that was already sent is only repeated after you confirm it. Manual sends still respect product eligibility and existing reviews; administrators can tick Ignore eligibility checks for the order rules.
• Reset never deletes reviews. It revokes the old links, clears the email progress and starts again for the products without a review.

On the WooCommerce Orders screen

• A Review request column with a short status (Not Requested, Email Sent, Awaiting Review, Partially Reviewed, Reviewed, Failed) that links to the order's detail screen.
• Bulk actions for the selected orders: send the initial email, the first or the final reminder, cancel pending reminders and retry failed emails.
• A Review request box on the order edit screen with the status, the three emails and one-click actions.
• Works with HPOS and with the classic order list, and does not interfere with WooCommerce's filtering, sorting or other plugins' actions.

Bulk sending

• Background processing. A bulk action never sends emails during the click. Each order becomes one queued job, so hundreds of orders are safe.
• Every order is checked on its own. Ineligible orders, orders without a billing email, products that were already reviewed and emails that were already sent are skipped and logged. A bulk action never repeats an email that was already sent.
• A summary. A banner shows how many orders are done, skipped or failed, and the Email log shows each one with the trigger Bulk action.
• Confirmation. You are asked before emails are queued and for large selections.
• Sending limit. Set a maximum of emails per hour; the rest waits in the queue.

Add a review for a customer

• Load an order, choose one of its products, and the customer's name and email are filled in from the order. Or search for a product and a customer without an order.
• The review is saved as a normal review, Pending unless you choose Approved. With an order it is recorded as a verified purchase only if the order is paid and contains the product.
• Without an order you can tick Verified Buyer, for a customer you know bought the product (an offline or old order). It is recorded as set by you, not proven by an order, and the customer email is optional.
• It is marked as entered by an administrator, with your user and the time, in a box on the review's edit screen, so it is never mistaken for a review the customer wrote. An order note records it too.
• Duplicates for the same order and product are refused.

Email log and reliability

• Each attempt records the order, product when relevant, address, type, scheduled time, attempt time, result, error text, the trigger (automatic, manual or bulk) and the administrator for manual sends.
• The result is worded honestly: Handed to mail system means WordPress passed it on without an error. It is not proof of delivery.
• Newest first; filter by order, type, result and date. Message bodies are not stored, and old rows are deleted after the retention period you choose.
• The answer emails (published, coupon, reply, low rating alert) are logged too.

Tools

• Export every request as a CSV file (spreadsheet formulas in customer text are neutralised).
• Retry failed emails, clean up expired links, delete old log entries and re-create missing queue jobs.
• Scheduled jobs: the list of what is waiting in the queue.
• Reset the plugin's settings (administrators only) after a confirmation.

6. Admin screens

Everything is under WooCommerce → Review Requests, in seven tabs, plus a column and a box on the Orders screens. What customers see in My Account is described under Leave a review in My Account.

Review requests

At the top, a line for anything that needs you: reviews waiting for your approval (with Moderate reviews) and orders whose review email could not be sent (with Show them). Then four key numbers, with fixed counting rules so that nothing is counted twice:

All numbers in Insights opens the Insights tab.

The table has one row per order: the order number, date and status (with links to the email log and the order); the customer; the products with a status each; the three emails as a track with what comes next or what was sent last; and the overall review status with "x of y reviewed". Bulk actions are above the table.

Order detail

Open it with Details in the table, with the status in the Orders list, or from the box on the order screen. See the figure under Managing requests. Actions:

Add a review

See the figure under Add a review for a customer. Enter an order number and press Load order to choose one of its products and prefill the customer; leave the order empty to enter a review without an order (it is then verified only if you tick Verified Buyer).

Email log

Filters for order, type, result and dates. Columns: time, order, address, type, result, scheduled time, who triggered it and the details (the error text of a failure).

Settings

Seven sections with a Save button each. Saving one section never changes another, and options that depend on a switch are dimmed while it is off. All settings are listed under Settings.

Tools

7. Settings

Open Review Requests → Settings. The defaults are chosen so that the plugin works without changes. Subject, heading, additional content and the on/off switch of each email are in WooCommerce → Settings → Emails.

General

Who is asked, for which orders and products, and how long the review links last.

Email

Timing, what the emails show, sender and logo, the unsubscribe link and the low rating alert.

Review form

What the review page asks for, how reviews and names are shown and the colour of the page.

Product page

The reviews section on product pages, and the shortcodes and blocks.

Rewards

The thank-you coupon for reviewers: who gets one, the discount and the disclosure under rewarded reviews.

My Account

The Leave a review button on the customer's orders and the Your reviews list on the order page.

Data & privacy

Log retention and what happens when the plugin is deleted.

8. Developer reference

Hooks

// Never ask for reviews of products tagged "gift-card".
add_filter( 'wphub_reviews_product_problem', function ( $problem, $product_id ) {
    if ( '' === $problem && has_term( 'gift-card', 'product_tag', $product_id ) ) {
        return 'gift_card';
    }
    return $problem;
}, 10, 2 );

The seven emails are standard WooCommerce emails (ids wphub_reviews_initial, wphub_reviews_first, wphub_reviews_final, wphub_reviews_published, wphub_reviews_reward, wphub_reviews_reply and wphub_reviews_low_rating), so WooCommerce's own email filters such as woocommerce_email_subject_{id} apply. Review emails never carry attachments.

The product page section

• Swapped in on comments_template for product pages only (WooCommerce's single-product-reviews.php); a theme can override it with yourtheme/wphub-reviews/product-reviews.php. Its stylesheet is printed right before the section and its script in the footer, only on pages that show the section, a slider or a badge.
• Filters, sorting and Show more reviews call admin-ajax.php?action=wphub_reviews_list, votes wphub_reviews_vote (both also for visitors; read-only lists and one vote per visitor need no nonce). A guest's vote is kept with a random id in the cookie wphub_reviews_voter; votes are limited to 60 per hour per address.
• The rating summary of a product is cached in the transient wphub_reviews_sum_{product id} and the shop's in wphub_reviews_store_stats; both are cleared when a review changes.
• Colours: --wphub-pr-accent and --wphub-pr-on-accent on .wphub-pr, .wphub-rw (slider) and .wphub-rb (badge), set from the review page colour.

The My Account button

• The button is the WooCommerce order action wphub-reviews-leave (filter woocommerce_my_account_my_orders_actions), so it is printed by WooCommerce's own templates and by themes that call wc_get_account_orders_actions(). Its CSS class is wphub-reviews-leave.
• Its URL is the order page plus ?wphub-review-order=<order id>&_wpnonce=<nonce> (and &wphub-review-product=<product id> from the list). A handler on template_redirect checks the signed-in customer, the nonce and the order, creates the review request if there is none (no email is scheduled), renews an expired link and redirects to the review page with via=account.
• via=account only marks where the visit came from; it is stored with the review as _wphub_reviews_channel for the dashboard. It never grants access.
• The list on the order page is printed on woocommerce_order_details_after_order_table (priority 20), styled by assets/css/account.css under .wphub-reviews-account.

Queue jobs

• wphub_reviews_process_stage( $order_id, $stage ) sends one email of the sequence. A job that runs before the time on the record (left over from an earlier plan) puts itself back at that time.
• wphub_reviews_bulk_item( $batch_id, $order_id, $action, $admin_id ) runs one order of a bulk action.
• Both run in the Action Scheduler group wphub-reviews (WooCommerce → Status → Scheduled Actions) and are de-duplicated. Without Action Scheduler the same hooks run from WP-Cron. Deactivating the plugin and deleting its data cancel them.

Data model

The orders and items tables also hold reward_coupon_id: 0 for no coupon, -1 while one is being created, else the coupon's id.

Email statuses: none, scheduled, sending, sent, failed, skipped, cancelled. Product statuses: requested, submitting, submitted (awaiting approval), approved, rejected (trashed, spam or deleted), skipped, cancelled.

Review meta

Reason codes

Order: missing, reviews_disabled, invalid_email, guest, status, refunded, min_value. Product: product_unavailable, reviews_closed, virtual, excluded_product, excluded_category, refunded_item, already_reviewed, repeat_purchase.

Template overrides

Copy templates/emails/wphub-review-request.php, wphub-review-published.php, wphub-review-reward.php, wphub-review-reply.php or wphub-review-alert.php (and the same files in templates/emails/plain/) to yourtheme/woocommerce/emails/ and yourtheme/woocommerce/emails/plain/. The reviews section: templates/product-reviews.php to yourtheme/wphub-reviews/product-reviews.php. The review page's look is set by one small stylesheet with CSS variables (--wh-accent, --wh-text, --wh-bg …) that you can override with your own CSS on the .wphub-reviews-page body class; the colour itself is a setting.

CSV export

Columns: order_id, order_date, customer, email, sequence, initial_status, initial_sent, first_status, first_sent, final_status, final_sent, products_eligible, products_reviewed, reviews_approved, reviews_awaiting_approval, last_email_at. Times are UTC.

9. Privacy and data

• Export and erase. The plugin registers a personal-data exporter and eraser by email address (Tools → Export / Erase Personal Data). The export includes the unsubscribe entry and the votes. Erasing removes the request records and log rows of that address, the votes of the account and the queued emails; the unsubscribe entry is kept (and reported as kept), because erasing it would let the review emails start again.
• Reviewer pictures. Initials by default. If you choose Gravatar, visitors' browsers load the pictures from gravatar.com.
• Suggested policy text is added under Settings → Privacy.
• Deleted orders. When an order is deleted, its request record and queue jobs are removed.
• The email address is never shown on the review page or on the product page, and links do not contain it or the order number.
• Outside servers. The only outside contact is the WpExperts Hub licence and update check, if you activate a licence. It sends the licence key, your site address and the plugin version.

Uninstalling

Deleting the plugin keeps everything unless Delete all plugin data on uninstall is on. With it on, the five tables, the settings, transients and queued jobs are removed. Reviews and thank-you coupons are never deleted.

10. Troubleshooting

First, the quick checks

• Review Requests → Email log shows every attempt with its result and error text.
• Review Requests → Tools → Scheduled jobs shows what is waiting in the queue, and WooCommerce → Status → Scheduled Actions (group wphub-reviews) shows the Action Scheduler side.
• Settings → Email shows whether each of the seven emails is enabled in WooCommerce.

Emails are not sent

The review page

The My Account button

The product page

Thank-you coupons

Reviews

11. FAQ

12. Changelog

1.3.0 · 2026-10-26

• New: reviews section on product pages: rating summary with a bar per star level, customer photos with a full-screen viewer, filters (stars, photos, verified buyers), sorting (newest, highest, lowest, most helpful), Was this helpful? votes and Show more reviews without reloading. Settings → Product page.
• New: five clickable stars under every product in the review emails; the review page opens with that rating selected.
• New: Stop review emails link and one-click unsubscribe header (RFC 8058) in every request and reminder, and Review Requests → Unsubscribed. Unsubscribed addresses are never asked again, whatever sends the email.
• New: thank-you coupons for reviews (Settings → Rewards, off by default): single use, for the order's email only, never depending on the rating, with a disclosure under rewarded reviews.
• New emails: Review published, Review thank-you coupon, Reply to a review (to the customer) and Low rating alert (to you).
• New: customers choose how their name is shown with the review (full name, "Maya C.", first name).
• New: shortcodes and blocks: reviews slider or wall, rating badge, product reviews section.
• New: Review Requests → Insights: emails and reviews per week, which email brought the reviews, rating distribution, ratings per product.
• Change: the dashboard shows what needs your attention and four key numbers; each order's three emails appear as a track. Settings are grouped, and options that depend on a switch are dimmed while it is off.
• Change: the review box in the admin says which email or button a review came from; the email log lists attempts newest first; a cancelled request still lists its products.
• Fix: deactivating the plugin, Delete all plugin data on uninstall and the reset now really remove the queued review emails (since 1.0.0 the queue jobs stayed behind).
• Fix: a queued email that runs before its planned time (left over from an earlier plan) waits for that time instead of going out early.
• Developer: hooks wphub_reviews_unsubscribed, wphub_reviews_reward_coupon, wphub_reviews_reward_created, wphub_reviews_list_page, wphub_reviews_review_card, wphub_reviews_slider_query; template wphub-reviews/product-reviews.php; two new tables (unsubscribe list, votes).

1.2.0 · 2026-10-13

• New: Leave a review button on the customer's orders in My Account → Orders and on the order page, for the signed-in customer of the order. It opens the same private review page as the email; an order without a review request gets one (no email is sent), and an expired link is renewed.
• New: Your reviews on the order page in My Account, with the status, stars and a Write a review button for every product.
• New: Settings → My Account (button and list on or off, button text).
• New: redesigned review page: order number and progress, star words, photo previews and checks before sending, an edit view for pending reviews, a thank-you screen, Back to your order, dark mode and a better phone layout.
• New: review page colour (default: the WooCommerce email base colour) and a preview of the review page with sample products.
• New: the customer's review link on the order detail screen with Copy link and Renew link.
• New: dashboard row with the average rating, the review rate and where reviews come from.
• Change: the settings sections use the same pill style as the tabs.
• Fix: themes with a narrow Actions column in the orders list make room for the review button instead of cutting it off.
• Developer: filter wphub_reviews_account_context; review meta _wphub_reviews_channel.

1.1.1 · 2026-10-11

• Fix: review request and reminder emails never carry an attachment. Invoice or packing-slip plugins that attach PDFs to customer emails can no longer add their files to a review email.

1.1.0 · 2026-10-10

• New: when an administrator adds a review without an order number, a Verified Buyer checkbox marks it as a Verified Buyer review, recorded as set by the administrator.
• Fix: the customer email is optional when an administrator adds a review without an order (1.0.1).

1.0.0 · 2026-10-10

• First release.
• Automatic review requests when an order is completed, with a reminder after 5 days and a final reminder 7 days later, all configurable.
• Three native WooCommerce emails with preview, test email, logo and sender settings.
• Private, accessible review page with ratings, optional titles and photos, spam protection and duplicate prevention.
• Pending WooCommerce reviews, Verified Buyer label based on the real order, and request status that follows moderation.
• Review Requests dashboard, order detail, email log, CSV export and tools.
• Orders screen column, bulk actions and an order meta box, on HPOS and classic storage.
• Add a review on behalf of a customer, marked as entered by an administrator.
• Personal data export and erase, log retention and a clean uninstall.
• Hooks for developers: wphub_reviews_order_problem, wphub_reviews_product_problem, wphub_reviews_review_created and wphub_reviews_email_sent.

13. Support

Email support@wpexpertshub.com and a person will help. Please include:

• Your order ID (from your purchase email or My Account on wpexpertshub.com).
• The plugin version (shown on Plugins) and your WordPress, WooCommerce and PHP versions.
• What you expected, what happened and what you already tried.
• The relevant rows from Review Requests → Email log and the error text of a failed email.
• Whether you use SMTP or an email service, and whether Action Scheduler or WP-Cron runs your queue.

Please do not send passwords or customer data. Support never needs them.