Documentation / Troubleshooting

Troubleshooting

If something isn’t behaving as expected, use the checks below. Most issues come down to trigger status, product configuration, or cached admin views.

Jobs are not being created

• Confirm the order status matches the trigger status in WooCommerce → Settings → Production.
• Confirm production tracking is enabled for the product in the Production Queue tab.
• Place a new test order after making changes (don’t rely on older orders).
• Check if the order contains products that are not configured for tracking.

Jobs are created, but attributes are missing

• Confirm the product has the correct attributes selected for inclusion in jobs.
• Confirm the order line item actually includes the chosen attribute values.
• Check Screen Options to ensure the attribute column is enabled.

Status or priority updates don’t save

• Confirm you’re logged in as an admin or shop manager.
• Try a hard refresh of the admin page.
• If you use a security plugin, ensure it isn’t blocking AJAX requests.

The queue feels slow

• Reduce the “jobs per page” setting.
• Use filters to narrow the list.
• Make sure server resources are adequate for your WooCommerce admin.

Order changes created unexpected jobs

• ProdQueue reconciles jobs when order items change.
• If an order moves backwards in your workflow, you can recreate jobs from the order actions.
• Cancelled jobs remain as history so you can audit what happened.