Common WooCommerce Setup Issues & Solutions

This section covers the most common issues users may encounter during WooCommerce setup and how to fix them.

Cart or Checkout Page Not Working #

Possible Cause: Required pages are not assigned.

Solution:

Go to WooCommerce → Settings → Advanced and make sure the following pages are selected:

• Cart Page
• Checkout Page
• My Account Page

Product Page Shows 404 Error #

Possible Cause: Permalink structure is not refreshed.

Solution:

Go to Settings → Permalinks and click Save Changes without modifying anything.

Add to Cart Not Working #

Possible Causes:

• AJAX is disabled
• JavaScript conflict with a plugin

Solution:

• Enable AJAX Add to Cart from Appearance → Customize → WooCommerce → General
• Temporarily disable third-party plugins to check for conflicts

Images Not Displaying Properly #

Possible Causes:

• Incorrect image sizes
• Mixed content (HTTP/HTTPS mismatch)

Solution:

• Regenerate thumbnails if needed
• Ensure your site is fully using HTTPS

Demo Import Shows Empty Pages #

Possible Cause: Server limits are too low.

Solution:

Increase the following PHP limits:

• memory_limit: 512M
• max_input_time: 900+
• upload_max_filesize: 256M+

Login / Registration Not Working #

Possible Cause: Membership is disabled.

Solution:

Go to Settings → General and enable:

• Anyone can register

Cart Page is Empty #

Possible Cause: Session or cache issue.

Solution:

• Clear browser cache
• Disable cache plugins temporarily

Checkout Page Not Loading or Stuck #

Possible Causes:

• Missing payment method
• JavaScript conflict

Solution:

• Enable at least one payment method from WooCommerce → Settings → Payments
• Disable third-party plugins to test conflicts

Prices Not Showing #

Possible Causes:

• Catalog Mode enabled
• Hide Prices option enabled

Solution:

• Go to Appearance → Customize → WooCommerce → General
• Disable Catalog Mode and Hide Prices

Filters Not Working #

Possible Causes:

• Widgets not added to sidebar
• AJAX disabled

Solution:

• Add filter widgets from Appearance → Widgets
• Enable AJAX from Appearance → Customize → WooCommerce → General

Product Variations Not Showing #

Possible Cause: Attributes not configured correctly.

Solution:

• Create attributes from Products → Attributes
• Use them in Variable Product settings
• Make sure “Used for variations” is enabled

Emails Not Sending #

Possible Cause: Server email configuration issue.

Solution:

• Use an SMTP plugin (recommended)
• Check WooCommerce → Settings → Emails

Tip: Most issues are related to incorrect setup, missing configuration, or server limitations rather than the theme itself.