Ahosting Logo
Knowledge Base

WooCommerce Troubleshooting Guide

This guide covers common WooCommerce issues and how to resolve them.

Issue: White Screen of Death

Symptoms: Blank white page, no error message

Causes: PHP error, memory limit, plugin conflict

Solutions:

  1. Enable WordPress debug mode in wp-config.php:
    define('WP_DEBUG', true);
    define('WP_DEBUG_LOG', true);
  2. Check /wp-content/debug.log for errors
  3. Increase PHP memory limit:
    define('WP_MEMORY_LIMIT', '256M');
  4. Deactivate all plugins via FTP, then reactivate one by one

Issue: Checkout Not Working

Symptoms: Cannot complete purchase, spinning loader, error messages

Solutions:

  1. Clear cache (browser and site cache)
  2. Check WooCommerce > Status > System Status for issues
  3. Verify payment gateway settings
  4. Test in incognito mode
  5. Switch to a default theme temporarily
  6. Check browser console for JavaScript errors

Issue: Products Not Showing

Solutions:

  • Check product visibility settings (Catalog visibility)
  • Verify product is published, not draft
  • Clear cache
  • Check category assignments
  • Rebuild permalinks (Settings > Permalinks > Save)

Issue: Shipping Options Not Appearing

Solutions:

  1. Go to WooCommerce > Settings > Shipping
  2. Verify shipping zones are configured
  3. Check shipping class assignments on products
  4. Ensure customer address matches a shipping zone
  5. Clear cart and try again

Issue: Emails Not Sending

Solutions:

  1. Check WooCommerce > Settings > Emails (verify enabled)
  2. Check spam folder
  3. Install WP Mail SMTP plugin
  4. Configure SMTP with your email provider
  5. Test with WP Mail SMTP email test feature

Issue: Slow Store Performance

Solutions:

  • Install and configure LiteSpeed Cache
  • Optimize images
  • Reduce number of plugins
  • Use a CDN
  • Clean database
  • See our guide: WooCommerce Speed Optimization Tips

Issue: Cart Showing Wrong Totals

Solutions:

  • Clear cache
  • Check tax settings
  • Verify coupon configurations
  • Check shipping calculations
  • Disable conflicting plugins

WooCommerce System Status

Go to WooCommerce > Status to view:

  • System environment details
  • Active plugins
  • Template overrides
  • Database information

Use the Get system report button when contacting support.

General Troubleshooting Steps

  1. Clear all caches (browser, plugin, server)
  2. Test in incognito mode
  3. Switch to default theme (Storefront)
  4. Deactivate plugins except WooCommerce
  5. Update everything
  6. Check error logs

Still stuck? Contact Ahosting support with your system status report and a description of the issue.