Monitor Loyalty Background Jobs
Track redefine, level reset, points zero-all, birthday reward, and anniversary reward batch jobs.
Applies to 1.2.2+
Stable
Verified July 29, 2026
WooCommerce Loyalty uses background batches for operations that may touch many users. Monitoring these jobs helps you confirm progress without keeping the browser open for large customer lists.
Where To Check Status
- Go to WooCommerce > Settings > Loyalty > Tools.
- Find the Calculation section.
- Check Background redefine status after clicking Redefine.
- Check Recent batch jobs for level reset, points zero-all, birthday rewards, and anniversary rewards.
Statuses You May See
| Status | Meaning |
|---|---|
| Queued | The job was created and is waiting for Action Scheduler or the fallback runner. |
| Running | The job is processing users in batches and updating progress. |
| Completed | The job reached the end of the user list. |
| Failed | The job stopped because required rules or data were invalid. |
Job Types
| Job | What it does |
|---|---|
| Redefine loyalty levels | Recalculates customer roles from their earning points and loyalty level thresholds. |
| Level reset | Resets matching loyalty-level users and clears earning points according to the reset action. |
| Points zero-all | Sets point balances to zero for users with positive point balances when fixed-date expiration requires it. |
| Birthday rewards | Processes eligible birthday rewards in batches. |
| Anniversary rewards | Processes eligible anniversary rewards in batches. |
If A Job Looks Stuck
- Refresh the Tools page and check whether the processed count or last updated time changed.
- Go to WooCommerce > Status > Scheduled Actions if Action Scheduler is available.
- Search for hooks such as
yowcl_redefine_loyalty_levels_batchoryowcl_points_zero_all_run. - Confirm there are no fatal errors in WooCommerce logs or PHP error logs.
- Avoid clicking the same bulk operation repeatedly while a queued or running job already exists.
Best Practices
- Run large redefine or reset actions outside peak checkout hours.
- Back up customer data before bulk-changing levels or points.
- Record the previous loyalty level thresholds before changing them.
- After completion, spot-check a few customers from low, middle, and high tiers.
Continue from WooCommerce Loyalty Points & Rewards documentation to the complete product workflow.
Evaluate product scope on the money page, use the pillar Guide for decisions and trade-offs, and return here for exact configuration.
Did this guide answer your question?
Still stuck?
Open a support request and include this article title, your plugin version, and what you already tried.
Open Support