WooCommerce Docs

Documentation, Reference Materials, and Tutorials for your WooCommerce products


WooCommerce Helper

Install the WooCommerce Helper to help activate your WooCommerce Subscription key(s). Activating your key(s) on your site will enable:

  • Easy Updates via the WordPress Updates page.
  • Support from our team.

Just remember we will only provide support for sites with an activated Subscription key for that product.

Installation ↑ Back to Top

To install the WooCommerce Helper plugin:

  1. Download the WooCommerce Helper plugin (woothemes-updater.zip file).
  2. Go to: Plugins > Add New.
  3. Select Uploads Plugin at the top.
  4. Choose File and select the woothemes-updater .zip file.
  5. Select Install Now.
  6. Then Activate the plugin.

Activating Subscription Keys ↑ Back to Top

On your site or store, go to: Dashboard > WooCommerce Helper.
Under the Subscriptions tab you can connect your WooCommerce.com account to activate subscription keys or manually copy and paste subscription keys for all of your WooCommerce.com purchases. The Help tab is full of other resources for our products.

WooCommerce Helper Screen

Automatically Activate Keys

  1. Click the big blue Connect your WooCommerce.com Account button.
  2. Log into the appropriate WooCommerce.com account if needed.
  3. Click connect account.

All subscription keys for the products on that site are connected and activated for you.

Manually Add Keys

You can still manually add your subscription keys if you don’t want to connect your WooCommerce.com account to the WooCommerce Helper on a particular site.

Manually Add Subscription Key

  1. Go to: My Subscriptions tab in your WooCommerce.com account.
  2. Copy the key for the relevant product
  3. Go to the WooCommerce Helper Subscriptions tab and paste the subscription key into the field for your product.
  4. Select the Connect Subscriptions button to activate the key.

Missing Plugin, Extension or Theme ↑ Back to Top

Plugins, extensions or themes that are missing from the list of Subscriptions are those that need to be manually updated. It means that the version you have is old enough it cannot be detected by the WooCommerce Helper.

All settings are saved on your site, so if you’ve not modified/customized the theme or plugin files, you can download the latest version from your account page and manually update the product.

It will then display in the WooCommerce Helper, and you can activate your subscription key(s).

Moving keys ↑ Back to Top

Should you have a single site subscription/key, but need to test often between a staging and production (i.e., Test and live sites) here’s how to manage that.

  • Activate the key on the site you need it most, so you’re getting support and updates on that site. The product still functions 100% without an active key; you won’t get easy updates or support for that site without it activated.


  • Move keys from site to site. Deactivate your key and reactivate on the other site. Go to your WooCommerce Account Dashboard > My  Subscriptions page.

Deactivate the key:


Then reactivate the same key by on the next site by going to your respective site’s Dashboard and following instructions above in Activating Subscription Keys.

Step-by-step instructions are found at: Deactivate/Reactivate Your Subscription Key.

Updating products ↑ Back to Top

Once you have activated keys for product(s), WordPress will be able to update them from the Updates page.

It is important to use a child theme, or hooks and filters if you customizations the core code of a product. If you do not use a child theme/hooks and filters and you update a product you will lose your customizations.


To update your product(s):

  1. Go toDashboard > Updates.
  2. Check the box for your product under Plugins/Themes.
  3. Select the Update Plugins/Themes button.
Updating your product through Dashboard > Updates.
Updating your product through Dashboard > Updates.

Help Tab ↑ Back to Top

The Help tab contains the most common links to get started with our products.


WordPress Multisite ↑ Back to Top

The WooCommerce Helper works with a multisite. You’ll need to network-activate the WooCommerce Helper to activate your keys and also network-activate the extensions.

The following extensions SHOULD NOT be network activated and must be updated manually*

  • PayPal Express
  • Western Union
  • Catalog Restrictions
  • Software Add On
  • WooCommerce Recommendation Engine
  • WooCommerce Compare Products Pro
  • WooCommerce US Export
  • WooCommerce Review for Discount
  • WooCommerce Follow Up Emails
  • WooCommerce Cart Notices
  • WooCommerce Advanced Notifications
  • WooCommerce Amazon S3 Storage
  • Royal Mail Shipping Module for WooCommerce
  • Table Rate Shipping

*These extensions create database tables and/or new pages and are not set up to do this on a multisite network.

Key Exceeded Activation ↑ Back to Top

If you receive the following message: “This has exceeded the number of times it can be activated.”

Go to: WooCommerce Account Dashboard > My Subscriptions tab to ‘Deactivate‘ your key for the URL that is no longer in use. Then reactivate on your WordPress site via Dashboard > WooCommerce Helper.

Tip: The above steps apply if you change your WordPress URL at any time. This includes moving from a staging server, adding or removing “www” from the URL under Settings > General, or changing from “http” to “https”.

How key activations work

When transferring your website — even from a staging server on a platform such as WPEngine — the keys remain “active” on your website’s database, but are not actually active on our servers.

Keys are active for specific URLs. Therefore, when moving from a staging server or other URL, the URL changes and makes the key inactive.

Common Issues ↑ Back to Top

Common issues with the WooCommerce Helper may include:

WooCommerce Helper isn’t updating.

Your server may be blocking connections to WooCommerce.com via a firewall. The best solution is to check with your web host.

My key says it’s been activated already.

Follow the step-by-step instructions: Deactivate/Reactivate your key. This typically fixes the issue.

My updates aren’t showing.

Either you haven’t activated a key, or the server is blocking the connection. If the latter, check with your web host.

Everything looks to be activated, yet no updates are coming through.

Either a) there are no updates or b) you activated the key, changed the site URL or changed from http to https, and now it is not picking up the updates.

This has been resolved in the latest version of the Helper, the key is automatically deactivated if the URL doesn’t match correctly, but your WordPress installation may think the key is still active so deactivate and reactivate it in your WordPress admin.

‘No license keys were specified for activation.’

If you receive this error, go to WooCommerce > System Status Report to check if SUHOSIN is activated on your site.


If SUHOSIN is activated this means your hosting provider is likely setting a suhosin.post.max_name_length variable in the config which causes inputs with long names, like the license key inputs, to be discarded when you click ‘Activate’ as it is longer then the limit in the config.

If activated, contact your hosting provider about removing the suhosin.post.max_name_length limit or increasing it to 200 so key activations can work.

FAQ ↑ Back to Top

Why do I need a key?

A key gives you:

  • Two-click updates of the product.
  • Support for the product through our Help Desk.

Note that we only provide support on tickets for websites that have authenticated keys.

Will my product work without the key activated?


Why is my theme not showing up in the WooCommerce Helper?

If you have an older version downloaded before 26th November 2013, you need to manually update your theme, as there is a new theme_info.txt file inside your theme zip file which is needed.

What happens to my translation (.mo/.po/.pot) files on automatic update?

If a language file is contained within the plugin itself, and is not a part of the original plugin package (e.g., You added it yourself), this language file will be overwritten in the same way it would be overwritten in a theme.

For language files, we recommend creating a wp-content/languages folder, to store your translations when upgrading a theme or plugin.

Why can’t I see my products in the Dashboard > Updates page?

If you can’t see your products, you might need to tell WordPress to force check by clicking the Check Again button at the top of Dashboard > Updates screen. It may take a few times to work.

I’m missing keys for plugins/themes on My Subscriptions account page. Where are they?

If you have purchased products and are missing keys, submit a ticket at our Help Desk with the order number for products you are missing.

Do you have more info on keys?

Yes we have an extensive section in our WooThemes FAQ with the most common questions asked about keys and subscriptions.

Questions ↑ Back to Top

Already searched this page and still need assistance? Get in touch with a Ninja via the Help Desk.

Back to the top