Sign In

Troubleshooting

URL coupon is not applying when the customer visits the link. The token may be expired or exhausted. Go to the coupon edit screen → URL & Obfuscation tab and check the token’s status badge. If it shows “Expired” or “Exhausted,” generate a new token. Also confirm the URL parameter name in WooCommerce → Settings → CouponCraft → URL Coupons matches the parameter in your URL.

Label changes are not showing in the Block Checkout. CouponCraft uses wp.i18n.setLocaleData() to override labels in the block editor. If your theme or another plugin is loading conflicting translation overrides, they may take precedence. Try deactivating other plugins to test.

Auto-apply coupon is not being applied. Confirm that the coupon is published, not expired, and has not reached its WooCommerce usage limit. Then verify that all conditions on the Auto-Apply tab are met — all configured conditions must pass simultaneously (AND logic). Also confirm the Enable CouponCraft checkbox is on.

Cashback credit is not being issued. Check that the order has reached the trigger status configured on the coupon’s Cashback tab (Completed and/or Processing). If using “Auto-detect” integration, confirm whether Smart Coupons or Points & Rewards is active — CouponCraft will try to use them if detected. Switching to Native in the Cashback settings may help narrow down integration issues.

Address restriction is not blocking a coupon I expected it to. Verify that the customer filled in the address you’re validating against (billing vs. shipping). Guests may not enter a shipping address if the order is virtual. Check which Address type to validate is set on the coupon.

“Settings not saving” after clicking Save changes. Ensure you have the manage_woocommerce capability on your user account. Then disable other plugins one at a time to check for a conflict.

General troubleshooting steps:

  1. Ensure WooCommerce is updated to the minimum required version (9.0+).
  2. Switch to a default theme (Storefront or Twenty Twenty-Four) to rule out theme conflicts.
  3. Deactivate other plugins one at a time to identify conflicts.
  4. Clear all caches: page cache, object cache, CDN, and browser cache.
  5. Check your browser console (F12) for JavaScript errors.
  6. Enable WP_DEBUG in wp-config.php and review wp-content/debug.log.