`** but the widget is blank: JavaScript isn't executing. Check the browser console for errors. Common culprits: ad-blockers, a JS error elsewhere on the page, or `wp_footer()` missing from your theme.
* **If you don't see `yuko-reviews` anywhere:** the shortcode, block, or template hook isn't firing. Re-check widget placement in the Yuko dashboard, and confirm your theme doesn't override `single-product.php` in a way that strips Yuko's hooks.
***
## Star rating shows zero on category / archive pages
Yuko disables the category-page star widget by default to protect archive page speed. Turn it on:
**Reviews → Widgets → Star Rating → Preferences → Show on category pages** → **ON**
Or enable the filter in code:
```php theme={null}
add_filter( 'yuko_enable_category_page_rating_widget', '__return_true' );
```
After enabling, clear cache and reload a category page.
***
## Rich snippets / star rating not showing in Google
Google takes 2–4 weeks to re-crawl and display schema changes. Verify your schema is correct:
1. Open any product page
2. Paste the URL into [Google Rich Results Test](https://search.google.com/test/rich-results)
3. You should see a **Product** result with `aggregateRating`
If the test passes, wait for Google's next crawl. If it fails, see **[Google SEO integration](/integrations/google-seo)** for a full schema checklist.
***
## Need Help?
Talk to our team for personalized setup help
**Time:** 30 minutes
Reach our team at yukoreviews.com/support
**Response time:** Within 24 hours
Browse detailed guides for every feature
Connect Yuko with other tools
# Sync Issues
Source: https://docs.yukoreviews.com/troubleshooting/sync-issues
Products, orders, or customers missing from Yuko — or out of date — here's how to fix it.
***
## How Yuko sync works
Yuko keeps a copy of your products, orders, and customers for fast lookup during review workflows. Syncing happens three ways:
1. **Real-time webhooks** — fire on `order.updated`, `product.updated`, `customer.deleted`, etc. This is how most data gets in.
2. **Scheduled recovery** — the `yuko_reactivate_disabled_webhooks` action re-enables any webhooks WooCommerce has disabled after delivery failures.
3. **Manual sync** — you click **Sync Data** in **Account → Integrations → WooCommerce**.
If data is missing or stale, one of these three failed.
***
## Products missing from Yuko
By default, Yuko only syncs products with status **Published**. Draft, Pending Review, and Private products are skipped.
To include other statuses:
```php theme={null}
add_filter( 'yuko_product_sync_status', function ( $statuses ) {
$statuses[] = 'private';
return $statuses;
} );
```
Initial sync of 1,000+ products takes 5–15 minutes. Check progress at **Account → Integrations → WooCommerce → Configure** — you'll see "Syncing X of Y products".
Don't click **Sync Now** again until the current sync completes; it queues a duplicate run.
If you recently enabled **High-Performance Order Storage**, WooCommerce is still migrating your legacy orders. Yuko mirrors WooCommerce — until HPOS migration is done, order sync may stall.
Check **WooCommerce → Status → Tools → Verify base database tables**. If HPOS shows "In progress", wait it out.
WooCommerce auto-disables webhooks after 5 consecutive failures. If your site was down or slow recently, a webhook may be turned off.
Yuko schedules a recovery task (`yuko_reactivate_disabled_webhooks`) that re-enables disabled webhooks automatically on its next run.
To fix now without waiting: **WordPress Admin → WooCommerce → Settings → Advanced → Webhooks** — find Yuko webhooks and set status to **Active**.
***
## Orders missing from Yuko
Yuko tracks `order.paid` (status → Processing), `order.fulfilled` (status → Completed), and `order.cancelled`. Orders that skip straight to Completed without ever being Processing may miss the `paid` event. This is cosmetic unless your workflow depends on it.
Guest checkout orders without an email (test orders, manual entries) can't be synced — Yuko needs an email address to send review requests.
The `yuko_blocked_order_statuses_for_webhooks` filter excludes Draft and Auto-Draft orders by default. If you've added custom statuses, check your theme's `functions.php`.
***
## Customer data is stale
Customer records (name, email) are synced on creation and update. If a customer updates their email in **My Account** but you still see the old address in Yuko:
1. WordPress Admin → Users → Edit the customer → Save (this fires the update event)
2. Or force a full customer sync: **Yuko Dashboard → Account → Integrations → WooCommerce → Configure → Sync Customers**
Deleted customers in WordPress trigger a `customer.deleted` webhook and are removed from Yuko within a few seconds.
***
## Force a full manual sync
When in doubt, reset the sync:
Yuko Dashboard → **Account → Integrations → WooCommerce → Configure**
This re-pulls products, customers, and recent orders from WooCommerce via the REST API. Takes 1–15 minutes depending on store size.
Stay on the page — if you navigate away, the sync continues but you lose the progress view.
After sync completes, verify a known product and a recent order both appear in Yuko with correct data.
***
## Still out of sync?
A persistent sync gap usually means the webhook pipeline is broken. Gather:
* A specific example (order ID / product ID that's missing)
* The timestamp of the event in WooCommerce
* The status showing in **WordPress Admin → WooCommerce → Settings → Advanced → Webhooks** for the Yuko webhooks
Then [contact support](https://yukoreviews.com/support) with those details — we can trace the delivery log on our side.
***
## Need Help?
Talk to our team for personalized setup help
**Time:** 30 minutes
Reach our team at yukoreviews.com/support
**Response time:** Within 24 hours
Browse detailed guides for every feature
Connect Yuko with other tools
# Getting Started with Workflows
Source: https://docs.yukoreviews.com/workflows/getting-started-with-workflows
Learn the basics of creating and managing automated review workflows
### **Navigation**
Yuko Dashboard → **Workflows → Create New Workflow**
![Yuko Add Workflows]()
### **How Workflows Work**
Each workflow follows a **trigger → condition → action** structure:
1. **Trigger:** What event starts the workflow (e.g., “Order Fulfilled”).
2. **Condition:** Who or what qualifies for the workflow (e.g., “Customer has not reviewed”).
3. **Action:** What happens (e.g., “Send review request email”).
You can create multiple workflows for different use cases.
### **Default Workflows**
Yuko provides three ready-to-use workflows out of the box:
* **Review Request Workflow**
* **Review Reminder Workflow**
* **Review Submitted & Reward Workflow**
You can customize or duplicate them anytime.
***
# Workflows
Source: https://docs.yukoreviews.com/workflows/index
Automate review collection and follow-up actions using customizable workflows.
Automate your review collection and engagement effortlessly.\
Yuko’s **Workflows** feature helps you send the right message to the right customer — at exactly the right time.\
You can create smart automation sequences for review requests, reminders, rewards, and follow-up messages, all within a single dashboard.
### **Navigation**
Yuko Dashboard → **Workflows**
![Yuko Workflows]()
### **Overview**
Workflows save you time by automating repetitive review and reward tasks.\
Once set up, Yuko automatically triggers emails and actions based on your store’s events — such as order completion, review submission, or photo upload.
You can:
* Request product reviews automatically after purchase
* Send reminders to customers who haven’t reviewed yet
* Reward reviewers with discounts
* Trigger follow-up emails when reviews are posted
# Review Reminder Workflow
Source: https://docs.yukoreviews.com/workflows/review-reminder-workflow
Set up reminder emails nudging customers to complete their pending reviews.
### **Navigation**
Yuko Dashboard → **Workflows → Review Reminder Workflow**
### **Purpose**
Remind customers who haven’t left a review to complete it.\
This workflow gently nudges them with a second email.
### **How It Works**
**Trigger:** X days after “Review Request Email” sent\
**Condition:** Customer has not submitted a review\
**Action:** Send “Review Reminder Email”
### **Setup Steps**
1. Go to **Workflows → Review Reminder Workflow**.
2. Set the **trigger delay** (default: 5 days).
3. Choose the **Review Reminder Email** template.
Save and activate your workflow.
# Review Request Workflow
Source: https://docs.yukoreviews.com/workflows/review-request-workflow
Automate sending review requests to customers after their purchase.
### **Navigation**
Yuko Dashboard → **Workflows → Review Request Workflow**
![rr.png]()
### **Purpose**
Automatically send a review request email after a customer’s order is fulfilled.\
This is the most common workflow for collecting verified reviews.
### **How It Works**
**Trigger:** Order Fulfilled\
**Condition:** Customer has not received a review request yet\
**Action:** Send “Review Request Email” after a set delay
### **Setup Steps**
1. Go to **Workflows → Review Request Workflow**.
2. Set your **trigger** to “Order Fulfilled” or “Order Completed.”
3. Choose a **delay** — typically 5 to 7 days after fulfillment.
4. Select your **Review Request Email template.**
5. Save and activate the workflow.
# Review Submitted & Reward Workflow
Source: https://docs.yukoreviews.com/workflows/review-submitted-reward-workflow
Send rewards or incentives to customers after they successfully submit a review.
### **Navigation**
Yuko Dashboard → **Workflows → Review Submitted & Reward Workflow**
### **Purpose**
Automatically thank customers when they submit a review and reward them with a discount or coupon.
### **How It Works**
**Trigger:** Review Submitted\
**Condition:** Review includes text, photo, or both\
**Action:** Send “Reward for Writing Review” or “Photo Review Reward” email
### **Setup Steps**
1. Go to **Workflows → Review Submitted & Reward Workflow**.
2. Select **trigger:** “When Review is Submitted.”
3. Add a **condition:**
* Has Photo → send photo reward email
* Text-only → send regular reward email
4. Choose your reward type (Fixed Amount, Percentage, or Free Shipping).
5. Enter the coupon details or integration source (e.g., WPLoyalty).
Save and activate the workflow.
### **Example Use Case**
* A customer submits a photo review
* Workflow triggers immediately
* Yuko sends a “Thanks for your photo!” email with a 10% off coupon