WooCommerce 2.2, “Prowling Pangolin”, has arrived

Written by Matty Cohen on September 10, 2014 Blog, News, Product News.

TL;DR: WooCommerce version 2.2 is now available. Visit your WordPress dashboard to upgrade, and be sure to update your WooCommerce extensions prior to updating WooCommerce itself. For further information on how to upgrade, please view our upgrade guide. Be sure to make a backup before you start.

Today marks the latest milestone in the growth and lifetime of WooCommerce. After months of developing, testing and tweaking (as well as some more testing), the team who brought you Peppy Penguin are proud to present Prowling Pangolin, the latest release of WooCommerce, the world’s fastest growing eCommerce platform. Can we get a woo woo?

Amongst the many updates and fixes bundled into WooCommerce 2.2, the pangolin also boasts an array of new features to help make daily store management tasks easier for you, the store owner.

Refunding customers made easy

WooCommerce now includes a refund processing feature, making it easier to process (full or partial) refunds for your customers. If your chosen payment gateway supports refunds, WooCommerce will help you by automatically refunding your customer. If not, we’ve provided an intuitive interface for processing the refund with just a few clicks.

Speaking your language

It is important to us that you are be able to experience WooCommerce in your native tongue. To this end, we’ve improved how languages are handled within WooCommerce.

If you use WordPress in a language other than English, WooCommerce will detect this and download the translation file for your desired language, if we have one available.

Improvements to order management and stock control

To support the partial refunds feature, the order items and totals panels have been combined. As a result we have a simpler, more user friendly order management screen.

You can also now set stock management options (such as backorder support) at variation level giving much greater control over stock.

A new friend, and an admirable adjustment

simplifyWith WooCommerce 2.2, we are excited to announce the inclusion of the Simplify Commerce by MasterCard payment gateway directly into WooCommerce core! Simplify Commerce makes receiving payments extremely easy across all major brands, and integrates with our popular Subscriptions, Pre-Orders and Bookings extensions.

WooCommerce 2.2 is also a time where we have made a small adjustment to the inclusion of the Mijireh payment service. Mijireh is now running as a free extension for WooCommerce.

Download the free WooCommerce Mijireh integration, today.

If you were running the Mijireh payment gateway with older versions of WooCommerce, you will be presented with a one-click installation to get the new extension in place and have your payments system back up and running.

For the geeks out there

At one stage, one may ask oneself; “What makes the pangolin prowl?”. To which we answer, “Geeks, and loads of them. Over 270 contributors on GitHub, to be precise.”

To everyone who contributed to the development of WooCommerce 2.2 and has given of their time to advance WooCommerce, we thank you from the bottoms of our ninja hearts.

We’ve got some exciting new geek bits and bobs as well, notably the addition of PUT, POST and DELETE endpoints to the WooCommerce API (now at version 2), rounding out the full scope of the API’s capabilities.

How to upgrade

WooCommerce 2.2 is available for download today, via your WordPress admin dashboard.

Once available, be sure to upgrade a test copy of your website (on a staging server, preferably) before upgrading your website. Also, remember to upgrade your extensions before upgrading WooCommerce core itself! We’ve found this to be the smoothest upgrade routine.

For more advice on doing this right, view our upgrade guide.

Get full info on all the geekery included in WooCommerce 2.2 on our WooCommerce development blog.

We look forward to your feedback on the new features added to WooCommerce in version 2.2, and look forward to sharing many new alliterative animals with you in WooCommerce’s future, as we grow.

Having issues with upgrading WooCommerce? Please be sure to update all of your WooCommerce extensions prior to upgrading WooCommerce.

If issues persist, please log a ticket directly to our helpdesk.


66 Responses

  1. Anthony Hortin
    September 10, 2014 at 4:56 pm #

    Congrats on the new release guys. Looking forward to upgrading some of my sites and checking out the new features. Thanks for the great work!

  2. Case
    September 10, 2014 at 5:18 pm #

    I just updated and now I can’t access the wordpress admin. Update seemed to go smoothly, clicked to return to the plugins page and the browser just hangs. Tried to go to /wp-admin/ and it does the same.

    Shall I submit a ticket?

    • Warren Holmes
      September 10, 2014 at 5:22 pm #

      Hey Case

      Please do! We’re not aware of any issues that might create that.

    • Claudio
      September 10, 2014 at 6:00 pm #

      I recommend to update all plugins at once and not just the WooCommerce.

    • Chris Anderson
      September 10, 2014 at 9:32 pm #

      I had the same issue because I forgot to update the WooCommerce Customizer plugin before updating the core plugin. Simple renaming the woocommerce folder on my server let me back in to admin, then I could update in the proper order.

  3. kjetil
    September 10, 2014 at 6:20 pm #

    I just updated and now I can’t access the wordpress admin

    • Matty Cohen
      September 10, 2014 at 7:08 pm #

      Hi there,

      Please do log a ticket over on our helpdesk, where our ninjas are on hand to assist.

      Thank you. 🙂

      • Sol
        September 11, 2014 at 12:46 pm #

        TL;DR: haha

  4. Kirby Prickett
    September 10, 2014 at 8:11 pm #

    Woo woo! Congratulations on the new release 🙂

  5. Dragonator
    September 10, 2014 at 8:12 pm #

    Since I somehow need to have a paying account to tell this, I am going to tell this here. I am not looking for personal support, I just want the creators to know ASAP.

    I run Vantage, fully updated everything, I updated Woocommerce a few minutes ago, and it blanked out the WP-admin page, making it impossible to access controls. I had to go to the FTP, move all plugins to a temporary folder to deactivate them, then turned everything on, one by one.

    It is not any other plugin, it is not plugins or themes that needed updates, with me at least, it was the woo commerce that blanked my admin page. I will not reactivate my Woocommerce until I have a new update.

    Hope people soon fix this, good luck

    • Mark
      September 10, 2014 at 8:16 pm #

      Same. Had a hell of a time just getting back on my website. Finally got access again. When I try to activate WooCommerce now I get “Plugin could not be activated because it triggered a fatal error.”

      Submitted a ticket.

      • James
        September 10, 2014 at 8:21 pm #

        Sorry for the inconvenience here and thank you for submitting a ticket, we’ll be looking into this ASAP.

        Please let this serve as a lesson folks, as the post warns; Please do not update WooCommerce major releases live on your site. Also remember to update WP and any plugins / extensions before / simultaneously to WooCommerce itself.

        You guys may want to check out the dev blog for the latest developments.

        • Mark
          September 10, 2014 at 8:32 pm #

          Cheers, James.

          We’ll sort it in the end. Life would be boring if everything just worked.

        • Hugh Lashbrooke
          September 10, 2014 at 8:56 pm #

          The same goes for *any* major release of *any* plugin, as well as WordPress itself. Never update directly on a live site.

          • Sami
            September 10, 2014 at 9:19 pm #

            turkey language problem :S

            currency symbol does not appear


            Turkish is not pending , cancelled , completed

          • Sol
            September 11, 2014 at 12:40 pm #

            But that is really just a cop-out statement. You guys know that 90% of your users will simply update their existing instal.

            I would argue the point [b]NEVER[/b] release an update without first releasing it to 100 test clients 🙂

          • Claudio
            September 11, 2014 at 3:41 pm #

            @Sol More than 100 people have tested before the release.
            Since August 1st we are launching beta releases and asking users to test and several people attended and helped us.
            We keep everything transparent in our development blog: http://develop.woocommerce.com/woocommerce/
            In addition it is possible to follow the development process on Github.


          • James
            September 11, 2014 at 4:34 pm #

            There will always be bugs in major software releases.

            2.2 has been beta tested for over a month to iron out as many of those bugs as possible.

            I don’t really think it’s a cop out to suggest that folks test pieces of software that are mission critical to their business before flippantly updating it.

    • Rune
      September 10, 2014 at 11:51 pm #

      Same here, WP-admin gone after updating, nothing else was updateable just WooCommerce…

  6. pascala
    September 10, 2014 at 10:14 pm #

    I’m very disappointed. The ability to add products in the backoffice order environment is gone. This was a function that we frequently used

    • Gerhard
      September 11, 2014 at 7:52 am #

      Pascala, the ability is till there, was just changed a bit. When creating a new order click the add line item button http://cld.wthms.co/zR0a then click the Add products button http://cld.wthms.co/YQjN from where a screen will pop up where you can search for a product and add it to the order http://cld.wthms.co/sCwr

      • Pascal
        September 11, 2014 at 8:37 am #

        Hi Gerhard,

        I see, but wat i do is to add products to a existing order. Our customer order something but call me please add something. Before this update that was possible and we used it a lot.

        Kind regards,

        Pascal Arts

        • Gerhard
          September 11, 2014 at 8:41 am #

          Pascal, okay in that case, check that the order status is not in processing or completed as that means payment has been received and the order items is not editable anymore. Change the order status to on-hold and the same buttons should appear to add products.

          • Pascal
            September 11, 2014 at 9:15 am #

            Gerhard, thanks a lot for your quick response. I found it and it works fine.

            Have a nice day

      • mark
        September 11, 2014 at 12:50 pm #


        On this point when a new item (product, fee or delivery) why do we need to push a button to calculate the tax and totals. If I add an extra product it should calculate the TAX depending on the product TAX settings automatically.

  7. muzza
    September 11, 2014 at 5:33 am #

    Hey Woo, thanks for the update! I have two sites running seamlessly with V2.2

    Is Mijireh a payment gateway or does it just provide security between the payment gateway and Woocommerce? This has always confused me since Mijireh was integrated with Woocommerce.

  8. Mark
    September 11, 2014 at 7:19 am #

    My site is now working fine with the 2.2.2 update. Great support again, guys. Thanks

  9. silter
    September 11, 2014 at 7:33 am #

    v2.2 is updated with v2.2.2,
    but the 1.3 MB file size of the latest update seems too small compared to the 9MB of v2.1.12

    “NO LANGUAGE” files in the “i18n” folder except then the original/base English ones:


    What happened to all those translations?

    • Claudio
      September 11, 2014 at 3:19 pm #

      Improved language file handling

      One thing we started noticing with recent releases was that the filesize for WooCommerce was huge. 2.1.12 was over 8mb. This can make updating difficult for example if there are upload limits.

      The reason for the size; localisation files. Uncompressed we’re talking 32mb of PO and MO files in core.

      To resolve this, 2.2 includes a language pack downloader. PO and MO files will no longer be bundled with the plugin – they will be downloadable from your dashboard if you have the WPLANG constant set, or from a git repository if you wish to grab them manually.


      • Mekom AS
        September 11, 2014 at 3:34 pm #

        I manage to get the Norwegian language file into Codestyling Localization.

        But my edits isn’t shown on the frontend after I generate the MO-file.

        Do you now why?

        WP 4.0, WC 2.2.2

        • Mekom AS
          September 11, 2014 at 3:36 pm #

          I suspect that it was the Norwegian language file automatically installed that is saved somewhere else.

          I want to retranslate to get a personal touch on the web shop.

  10. Magnus
    September 11, 2014 at 9:16 am #


    You say: If you use WordPress in a language other than English, WooCommerce will detect this and download the translation file for your desired language, if we have one available.

    Just the line: “if we have one available” could need some more explanation how to submit a translation or if you have a list available… 🙂

    All the best

    • silter
      September 11, 2014 at 9:53 am #

      Thanks for the reply Magnus, but I must say that I am not a big fun of “Auto-Updates” because of the common malfunctions especially in the major plugin update processes. So most of the time; I want to upload my files via FTP on my own. Same goes even for the localization/translation files.

      (I am not only refferring to WooCommerce updates, this is my general approach; from the main core WordPress updates to the smallest theme style changes.)

      If Woo chose to remove the translation/localization files from the core of a FREE plugin published/distributed via the WordPress libraries, it will be a better idea to make those localizations to be downloaded seperately; not only available to update within the admin panel!

      And, first of all I need the localization file in my site’s language and than will need all those other language files for a further multi-language setup . So I can’t expect Woocommerce to detect and do everything automatically.

      In short:
      Is there a download link for the latest translation files of the newest version?

    • Mike
      September 11, 2014 at 11:23 am #

      I agree. For the record, users can submit translations via https://www.transifex.com/projects/p/woocommerce/ 🙂

  11. Dave Dean
    September 11, 2014 at 1:01 pm #

    Hi there,

    I’m experiencing a problem with the Mijireh extensions. I just updated a WooCommerce site to WordPress 4 and WooCommerce 2.2 (tried it on 2.2.2 as well).

    Installed the separate Mijireh extension.

    Now when I go to the “Mijireh Secure Checkout” page to slurp it the page fails to load properly. Something about the Mijireh meta box is causing the page to fail to load, nothing below the Mijireh meta box appears, the browser doesn’t get to load the .js files that are at the bottom of the source and so nothing works.

    Anyone else experiencing this? This is a pretty fresh site so there’s nothing unusual going on and not many other plugins installed.



    • Claudio
      September 11, 2014 at 8:30 pm #

      Works without any problem.
      Check if some plugin is causing JavaScript errors. and please report this in the appropriate place. Because I’ll be very happy to help you.

  12. douglsmith
    September 11, 2014 at 4:30 pm #

    Congratulations on the great release! There is a lot of good stuff packed into this one.

    I’ve noticed that many of my paid extensions recently had updates for compatibility with WC 2.2. However, many of them have not been updated. I’m sure a lot of them don’t need updates. But will there at least be an update to those extensions adding a note to the change log that it has been checked for compatibility?

    I’m eager to upgrade to 2.2 but I’m balancing that with how long I should wait for the paid extensions to be ready.

    • James
      September 11, 2014 at 4:40 pm #

      All extensions are 2.2 compatible, if there’s not an update for an extensions it’s because one wasn’t needed (it already works fine).

      Please don’t update WooCommerce on a production site though, test on a staging/local environment first.

      • douglsmith
        September 19, 2014 at 6:25 pm #

        And yet, as late as two days ago I was still seeing updates to some of my Woo purchased extensions, listing WC 2.2 compatibility in their change log. 😉

        Not to diminish this really great WC release, but proceeding cautiously on a staging server, as wisely recommended.

  13. Kurre
    September 11, 2014 at 6:58 pm #

    Hi guys,

    I am really excited about the new version of the REST API but I can’t find proper documentation on this anywhere. I know absolutely nothing about this type of programming but I have managed to get some basic information from order and customer info through v1.

    I would now like to import and update products through v2 but I can’t find any information for this.

    • Claudio
      September 11, 2014 at 8:32 pm #

      Here the docs: http://docs.woocommercev2.apiary.io/
      Now we have examples in cURL, PHP, Python, Java, Ruby, JavaScript, Node.js and more.

      • Claudio
        September 11, 2014 at 8:34 pm #

        Forgot to tell, we’re finishing up some docs yet.

        • Giancarlo
          October 17, 2014 at 11:55 am #

          Hi Claudio,

          I’ve got the Rest API working since v1 for downloading info from my webshops.
          Now with v2 I want to do some updating or adding new products.
          I just keep on getting 401 unauthorized messages from the server.
          I do have a API key with write rights, and no problem downloading info from HTTPS or HTTP shop.
          I followed the coupon example to add/update, but still this 401 error.
          It might be an ovelooked other (simple) setting, but I have no clue on where to start searching.

          Could you give some more insights on where to look for a solution, or a forum for more support?
          Or a step by step check list on the requirements to POST/PUT actions?


  14. Surbhi
    September 11, 2014 at 11:04 pm #


    For me plugins are working fine. Other admin controls are working fine except for the Orders controls. When I tried editing my orders the edit controls are just blank. The message displayed is “Order – September 12, 2014 @ 02:21 AM”.

    How do i fix this issue. Please help!!

    • Surbhi
      September 19, 2014 at 8:55 am #

      Can anyone please suggest, how do i fix the issue stated above?

  15. kimosogi
    September 11, 2014 at 11:22 pm #

    Got an issue with the new update. Everything works except add to cart does not work. It works when I am logged in to my admin account. But when I open a different browser and do not log in I add to cart but nothing shows up in checkout.

    • Indira
      September 15, 2014 at 5:48 pm #

      I have the same issue!!!

    • Nicolai
      October 8, 2014 at 9:10 pm #


      I have the same issue. Did you find a solution?

      / Nicolai

  16. karma
    September 11, 2014 at 11:39 pm #

    hi, i updated the wc 2.2 and now i have this message in my page
    “This is a demo store for testing purposes — no orders shall be fulfilled.“
    I deactivate wc plugin and that message disappear but also my info.
    I‘ve tried to deactivate all the plugins i have, but nothing happens.

    I have the WP latest version, and updated everything

  17. Peter
    September 12, 2014 at 9:03 am #

    The category archives give 404 after update. I know this can be fixed by resaving the permalink settings, but shouldn’t the permalinks be flushed by the update script?

    • Rob
      October 19, 2014 at 12:45 pm #

      Thanks Peter,

      Your comment just helped solve my 404 issues.

  18. Terry
    September 12, 2014 at 9:23 am #

    Congratulate on the new update. However everytime there’s a new woocommerce update, then my website is like a real mess. Many minor bugs have to fix. I’m your loyal customer, I may consider leaving you guys as if this issue is still existed. I’m using woocommerce in another language than English one.

  19. moakalabs
    September 13, 2014 at 8:56 pm #

    Hey Everyone. I Love WooCommerce and applaud all your efforts.
    Well its my turn for the White Screen of Death. I guess we all get it eventually. Updates up to 2.1.12 ran flawlessly. Update 2.2.2 – can’t make it work. I’ve spent so many hours on this now .. not a memory issue, not a conflicting plugin issue .. I’ve disabled ALL my plugins – WooCommerce will simply not work. I’ve managed to restore ver 2.1.12 but now my store is gone, I have to rebuild it I guess – I’ll be 30 hours into this by the time I’m done with no solution, running an old version .. life!
    If anyone has any suggestions .. I’d surely like to hear them.
    Cheers! (still a woo fan) Keith

    • moakalabs
      September 13, 2014 at 9:38 pm #

      Wow, sorry for the drama above .. I restored an older version of the site, took minutes. I’ll setup a test environment like I should have in the beginning and play with this. Sorry for the message above and thanks for any helpful suggestions you may have. Cheers!

  20. Vinay
    September 15, 2014 at 10:16 am #

    I just updated to the lastest 2.2 version. I have 2 products which are not visible in the admin backend.
    They are visible fine in the frontend site.

    All (2) | Published (2) | Sort Products
    Search Products:
    2 items
    Select All

    In the admin backend, the headers shows that there are 2 products but they do not show up in the list. Neither are they searchable or visible anywhere in backend.

    How do I fix this?

    • Ricardo
      September 16, 2014 at 4:07 pm #

      i also have this problem, there is any fix for this??

      • ade
        September 18, 2014 at 4:42 pm #

        Hello, I also have this problem but with all my products. Nothing is displayed in backend and i have at least 50 products.

        • Tomás
          October 24, 2014 at 3:54 pm #

          Also have the same problem – cannot see products on the back end!

  21. Brian Smith
    September 15, 2014 at 12:52 pm #

    Hi there , hope you can help?

    Since updating to the latest version of WC, all seems great apart from the Woocommerce dashboard status widget no longer updates itself as sales come in.

    Is there a fix for this??

    Many thanks in advance.


    • Kate
      October 31, 2014 at 12:45 am #

      I have the same issue. Any luck?

  22. achille
    September 15, 2014 at 12:58 pm #

    ciao a tutti sono nuovo del form, ho istallato da poco WooCommerce 2.2.2 ho problemi con la dimensione dell’immagine
    http://www.sasardinniainsamesa.com/?product=ichnusa e con la sgranatura come poso risolvere grazie

  23. kbaum
    September 15, 2014 at 5:29 pm #

    I can’t seem to search by SKU on the orders screen anymore. I tried SKU: 1234, sku: 1234, and just 1234 by itself. Did I miss something? Thanks!

    p.s. Great release!

  24. Andy
    October 17, 2014 at 10:14 am #

    With the new version when I try to add a product to an order in the backoffice, no matches were found – never. Any Idea what to change or adjust?

    • Andy
      October 17, 2014 at 10:39 am #

      Found out that the problem is connected to the theme I am using.