General Troubleshooting Steps

We work hard to proactively avoid conflicts and problems with other themes and plugins, but there will be times when problems crop up. 

Below is a general guide to troubleshooting problems. If you encounter a problem, follow these steps before reaching out to support (it will save time in the long run!)

Step 1: Update your plugins

If you're using outdated versions of WooCommerce, WooCommerce plugins, or Checkout for WooCommerce. The first course of action is to try updating these plugins to their latest version.

In many cases, the bug you are encountering may have already been fixed. 

Step 2: Make sure all conflicting plugins are deactivated. 

Any plugin that manages the checkout fields or the layout of the checkout page is very likely to cause problems with Checkout for WooCommerce. 

These plugins should be deactivated!

Step 3: Try disabling other plugins and testing a standard theme.

If you don't have a staging site, now is a great time to set one up!

Try deactivating all plugins except for:

  • WooCommerce
  • Checkout for WooCommerce
  • Payment Gateways
  • Shipping methods

If this fixes the problem, add the plugins back that you deactivated, one by one until the problem reoccurs. You will now know which plugin is causing the issue. Open a support ticket and send us a zip file (using a Dropbox or similar link) with a description of how you use the plugin, and any relevant API keys. 

We'll add support (or prevent it from breaking the checkout page).

If it doesn't fix the problem, try temporarily activating one of the standard WordPress themes.

If this fixes the problem, send us a zip file of your theme (and parent theme) using a Dropbox or similar link. We'll figure out what's going on and get you a fix as soon as we can. 

If it doesn't fix the problem, try deactivating your payment gateways and shipping methods, one by one, and testing to see which one is causing the problem. 

You'll have the problem plugin identified quickly using this strategy. 

What if I have a lot of plugins?

One way to speed up the process is to use a binary search. 

Basically, if you have 100 plugins, you would select 50 and deactivate those (obviously skipping the list above). 

Now test it again. If it fixes the problem, you know it's in that 50. If it doesn't fix it, you know it's in the other 50 and you can reactivate the first 50. Continue dividing the list in half until you get to the offending plugin. 

It's a process of elimination and it will be much faster than trying to randomly guess which plugin is causing the issue.