Reviewmend docs
v1.0.0
Get help
● Ship · When something is off

Troubleshooting
the usual causes.

Start with Reviewmend → System check and the Note column of Reviewmend → Requests. They name most problems directly. The sections below cover the rest.

System check firstRequests → Note

01No review requests appear

  • Requests are created when an order changes to the status in Settings. Orders completed before Reviewmend was active get none.
  • Check the status in Settings. If your shop marks orders Processing and never Completed, choose Processing or complete orders.
  • Look under Reviewmend → Requests → Skipped: the Note says which rule stopped it (Notes you may see).

02Requests stay Scheduled (WP-Cron / Action Scheduler not running)

Symptoms: the System check row Background sending warns that tasks are more than an hour late, or requests stay Scheduled long after their time.

  1. Look at the queueWooCommerce → Status → Scheduled Actions → Pending, search "reviewmend". Past-due reviewmend_dispatch actions mean nothing is running them.
  2. Check DISABLE_WP_CRONIf wp-config.php has define( 'DISABLE_WP_CRON', true );, a server cron job must call WP-Cron. Add one (Going live → Cron).
  3. Low trafficWP-Cron only runs on visits. Add the server cron job anyway.
  4. Blocked loopbackSecurity plugins, basic-auth on the whole site or a firewall can block WordPress calling itself. Tools → Site Health shows "loopback request" errors in that case; whitelist the server or use a server cron job.
  5. Failed actionsScheduled Actions → Failed shows the error message of a failed Reviewmend task.

Deactivating and activating Reviewmend recreates its recurring task.

03E-mails not arriving

  1. Send yourself a testReviewmend → Tools → Send me a test. If the notice says WordPress could not send it, the site cannot send mail at all.
  2. Install an SMTP pluginMany hosts block or throttle PHP's mail(). An SMTP plugin connected to your mail provider or a transactional e-mail service fixes most delivery problems, for every WooCommerce e-mail.
  3. Check the e-mail is onWooCommerce → Settings → Emails → Review request and Review reminder must be enabled.
  4. Check spamSet up SPF, DKIM and DMARC for the sending domain, and use a "From" address on that domain (WooCommerce → Settings → Emails).
  5. Failed requestsRequests → Failed shows "WordPress could not send the e-mail" with the mail error. Reviewmend tries three times (after 15 and 30 minutes) and then marks it Failed. Fix delivery, then press Send now.

04Reviews held for approval

Reviewmend publishes reviews through WordPress's own comment rules, so Settings → Discussion decides:

  • Comment must be manually approved: every new review waits in Products → Reviews.
  • Comment author must have a previously approved comment: a customer's first review waits for approval. This is the most common reason that reviews from requests are not visible right away.
  • Comment Moderation (number of links, words) and Disallowed Comment Keys: reviews that match are held or marked as spam.

The customer still sees the thank-you page (and coupon) immediately. Approve reviews under Products → Reviews. If you want reviews from verified buyers to appear at once, untick the two approval options; the System check row Review approval shows the current state.

05Page cache and the review page

The review page sends no-cache headers and defines DONOTCACHEPAGE, which most WordPress page cache plugins respect. Server and CDN caches (nginx FastCGI cache, Varnish, LiteSpeed server cache, Cloudflare cache rules) may not. If a customer sees someone else's form, "Open this page with the link from your review e-mail" even with a valid link, or a form that does not submit, exclude these from caching:

  • The review page path, by default /review-your-order/ (use your slug if you changed it).
  • Any URL with the query parameters rm, rm_preview or reviewmend_link.

Also make sure your cache does not strip query strings on product pages, or the review filters (rm_stars, rm_photos, rm_verified, rm_sort) show the unfiltered list.

06nginx and the import folder

During a CSV import the uploaded file sits in wp-content/uploads/reviewmend-import/. Reviewmend protects it with a deny-all .htaccess, which works on Apache and LiteSpeed. nginx ignores .htaccess, so add this to your site's server { } block and reload nginx:

location ^~ /wp-content/uploads/reviewmend-import/ {
    deny all;
    return 403;
}

Ask your host if you cannot edit the nginx configuration. The file also has a random name and is deleted when the import ends.

07Rate limiting behind a proxy

To slow down people guessing review links, Reviewmend counts invalid review links per IP address: after 30 in 10 minutes, that address sees "Please wait a moment". Valid links are not counted.

Reviewmend reads the IP from REMOTE_ADDR. Behind a reverse proxy, load balancer or CDN that is the proxy's address, so all visitors share one counter, and a few bad links can block everyone for 10 minutes. Make the real visitor IP reach PHP:

  • Cloudflare: restore visitor IPs on the server (Apache mod_remoteip or nginx real_ip with Cloudflare's IP ranges); many hosts have a switch for it.
  • nginx behind a proxy: set_real_ip_from <proxy IP>; and real_ip_header X-Forwarded-For;
  • Apache: mod_remoteip with RemoteIPHeader X-Forwarded-For and RemoteIPTrustedProxy.

Version 1.0.0 has no setting or filter to read another header; configure it on the server.

08Customers cannot upload photos

  • The System check row Uploads folder for review photos must be OK.
  • The size limit is the smaller of your Reviewmend setting and PHP's upload_max_filesize / post_max_size. Several large photos in one form can exceed post_max_size; raise it or lower the photo size.
  • Only JPG, PNG and WebP are accepted. iPhone HEIC photos must be converted (most phones do this when uploading through a browser).

09No coupon on the thank-you page

  • The coupon setting is off by default: Settings → Thank-you coupon.
  • WooCommerce → Settings → General → Enable the use of coupon codes must be on.

10The rating summary does not show on product pages

  • Settings → Product page → Review display must be on.
  • The product needs at least one approved review, and reviews must be enabled on the product. The star summary also needs WooCommerce's "Enable star rating on reviews".
  • The summary attaches to WooCommerce's review template and WooCommerce's review blocks. A page builder widget that renders reviews its own way is not covered in 1.0.0.

11Links lead to a missing page

The System check row Review page shows a Problem. If you deleted the page (and emptied it from the trash, or it is in the trash), deactivate and activate Reviewmend; it creates a new Review your order page, and e-mails sent after that link to it. If you removed the shortcode, add [reviewmend_review] back to the page.