Woocommerce



Note: This is a Developer level doc. If you are unfamiliar with code/templates and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our Support Policy.

The WooCommerce REST API lets you create, read, update, and delete WooCommerce data using HTTP requests, so you can integrate external applications with WooCommerce and build extensions that make use of asynchronous UI frameworks such as React.

  1. We look forward to discussing your ideas. NOTE: Please do not post links to/promote products outside of the WooCommerce.com catalog.This is not a sales channel. Links to outside sources, intended for spam or self-promotion, will be marked as spam.
  2. WooCommerce is the world’s most popular open-source eCommerce solution. Our core platform is free, flexible, and amplified by a global community. The freedom of open-source means you retain full ownership of your store’s content and data forever.

What are Webhooks? ↑ Back to top

Woocommerce Login

A Webhook is an event notification sent to a URL of your choice. Users can configure them to trigger events on one site to invoke behavior on another.

Webhooks are useful for integrating with third-party services and other external API that support them.

Webhooks in WooCommerce ↑ Back to top

Webhooks were introduced in WooCommerce 2.2 and can trigger events each time you add, edit or delete orders, products, coupons or customers.

It’s also possible to use webhooks with WooCommerce actions, e.g., Create a webhook to be used every time a product is added to the shopping cart, using the action woocommerce_add_to_cart.

Webhooks also make it easier for third-party apps to integrate with WooCommerce.

Creating webhooks ↑ Back to top

To create a new webhook:

1/ Go to: WooCommerce > Settings > Advanced > Webhooks.
Note: Webhooks were formerly found under WooCommerce > Settings > API prior to WooCommerce 3.4.

2/ Select Create a new webhook (first incident) or Add webhook. The Webhook Data box appears.

3/ Enter.

  • Name: The name is auto-generated as “Webhook created on [date and time of creation]” as a standard to facilitate creation. Change the name to something else.
  • Status: Set to Active (delivers payload), Paused (does not deliver), or Disabled (does not deliver due delivery failures).
  • Topic: Indicate when the webhook should be triggered – Order Created, Product Deleted, or Customer Updated. There are also Action and Custom options.
    • Action Event: This option is available when the Topic is a WooCommerce Action, such as woocommerce_add_to_cart for when customers add products to the shopping cart.
    • Custom Topic: This option is for advanced users only. It’s possible to introduce new, customized topics with the help of woocommerce_webhook_topic_hooks filter.
  • Delivery URL: URL where the webhook payload is delivered.
  • Secret: The Secret Key generates a hash of the delivered webhook and is provided in the request headers. This defaults to the current API user’s consumer secret, if nothing is entered.

4/ Save Webhook.

Note: The first time your webhook is saved with the Activated status, it sends a ping to the Delivery URL.

Editing and deleting webhooks ↑ Back to top

Webhooks are listed the same way as posts or products.

  1. Find the webhook you wish to alter.
  2. Hover over the name, and Edit and Delete permanently options appear.
  3. Delete, or make Edits and Save changes. Bulk deletion is also possible with the dropdown.

Webhook logs ↑ Back to top

WooCommerce saves logs of all events triggering a webhook. Webhook logs are found at: WooCommerce > Status > Logs.

Logs may be reviewed to see delivery and response from the server, making it simpler to integrate and debug.

What is WooCommerce? WooCommerce is a free WordPress plugin that adds e-commerce functionality to your WordPress website so you can have an online store. With just a few clicks, your WordPress website turns into a fully-functional e-commerce website.

If you’re asking “What is WooCommerce?”, chances are you already have a WordPress site, and you’re ready to begin selling, well, just about anything. In this post, we’ll cover what WooCommerce is, what it can do for you, and why you should use it.

What is WooCommerce? A Brief History

WooCommerce is a plugin that integrates easily with your existing WordPress site, turning your site into a fully functional WordPress e-commerce website with just a few clicks.

When the plugin was launched in 2011, it quickly became the primary solution for users looking to launch their own stores online.

Automattic (the owners of WordPress.com), acquired the plugin and its parent company in 2015 – it was their biggest acquisition to that date, and it has continued to experience explosive growth in the years since.

It currently powers over 99% of WordPress e-commerce websites in the US, Canada, and the UK (Source: BuiltWith.com.)

With over 27,000,000 downloads, and millions of active installations, it’s definitely the driving force behind numerous e-commerce sites (Source: WordPress.org.)

What Does WooCommerce Do?

WooCommerce provides basic store functionality right out of the box, with a free plugin available from the Plugin Repository, or right from your WordPress dashboard.

While it has hundreds of available extensions – more on that in a bit! – it offers some incredible functions right out of the box.

Easy Installation, Setup, and Integration

WooCommerce is designed to make getting started as easy as possible, with a simple installation and Setup Wizard to get your e-commerce store up and running with your WordPress theme.

  • Installation – The WooCommerce plugin is installed just like any other plugin; search for it in the Plugins options in your WordPress dashboard, and install and activate it with a couple of clicks.
  • Setup – When you install WooCommerce, the Setup Wizard will walk you through configuring basic steps to get your store up and running. Your e-commerce options are virtually endless, and the Setup Wizard cuts to the chase and highlights the most important options so you never miss a step.
  • WordPress Theme Integration – Because WooCommerce is compatible with WordPress, it works well with most WordPress themes. You can select the Storefront theme if you’d like to use the official theme – and just like the plugin, it’s free of charge!

Data Control

Never worry about losing control of your data – WooCommerce puts you in the driver’s seat.

  • Your Data, Always – When you use a third-party platform for e-commerce, if they close, your data is lost. With WooCommerce, you remain in charge of your data at all times. Data related to customer history and purchases, as well as store performance, is vital to running a successful e-commerce website.

Feature-packed Shopping Cart

Tailor your site visitor’s checkout process from start to finish, with processes that help you convert visitors into customers. From Payment Gateway to Checkout URLs, set up your site your way.

  • Payment Gateways – With WooCommerce, you can accept checks, cash on delivery, bank transfer, or use PayPal to accept major credit cards and other PayPal payments. Prefer Stripe? You can configure Stripe as a payment gateway using the Setup Wizard.
  • Geo-Location and Automatic Taxes – WooCommerce gives you the option to turn on geolocation and automatic taxes, so your shop will display the correct price including taxes to your customers, no matter where they are located.
  • Customizable Checkout Process – Completely control the checkout process from start to finish. You can choose to sell to specific countries or worldwide, set your checkout flow URLs, enable/disable guest checkout, and force secure checkout.
  • Default Currency – A wide variety of available currencies allows you to choose the currency you wish to use for your store.
  • Redirect Cart – You can enable the option to redirect your customer to their cart once a product is added.

Complete Control of Products

Whether you’re selling one product, one product with many options, or dozens, hundreds, or more … WooCommerce gives you total control over each and every one.

  • Unlimited Products – Start with your first product, and keep adding. WooCommerce gives you the option to add as many products as you’d like, only constrained by your hosting solution.
  • Product Types – Do you sell ebooks? Affiliate products? Your own one-of-a-kind stock? No problem. You can set your product type to Simple Product, Grouped Product, External/Affiliate Product, Variable Product or Virtual/Downloadable Product.
  • Product Variations – If your products are available with options, your customers can select those options when ordering, saving you both valuable time. Sizes, colors, prices, stock levels, images, and more can all be set for each available option.
  • Inventory – Take control of your inventory management! Stock levels, backorders, hiding out of stock inventory, email notifications when an item’s stock level is low or sold out, and more, all help you streamline and simplify product management.

Easy Shipping

WooCommerce not only makes selling your product easy, it makes it just as easy to get it to your customer. A variety of shipping options help connect your products to your customers with minimal effort!

Woocommerce
  • Shipping Options – Make shipping less of a hassle with built-in options to offer Flat rate, International Shipping, Local delivery, or Local pickup. Set your rate to Automatic, and give your customer the lowest rate based on their address – or even offer Free shipping.
  • Shipping Calculation, Display, and Destination – Hide the shipping rate until an address is entered, offer a Shipping Calculator in your shopping cart, and let your customer ship to their Billing Address only, or to a separate Shipping Address.

Easier Tax Management

Running a successful e-commerce store means dealing with taxes. WooCommerce simplifies that for you with a variety of options designed to make handling taxes much less stressful.

Jupyter notebook markdown shortcut

  • Tax Management – Since WooCommerce is an online product built for selling products online, handling taxes on sales is built right into the plugin. Custom tax rates, major tax rate calculation, and geo-location tax rates are just some of the available options. You can also define tax rates, and control the tax rate assigned to your shipping costs.

A Leader in Marketing and Search Engine Optimization

Building a better mousetrap won’t bring anyone to your door if they don’t know you’ve built it! WooCommerce leverages the power of WordPress SEO to help get the word out, and let your potential customers know you’re there.

Woocommerce
  • WordPress SEO – Because WooCommerce runs on WordPress, your e-commerce store gets the benefit of the baked-in SEO options provided in WordPress. Because of that and the granular controls provided for key SEO options, WooCommerce storefronts get a significant SEO boosting.
  • Coupons and Discounts – Easily enable discounts and coupon codes, without ever discounting tax.
  • Reviews – Product reviews are essential to encourage online sales, and you can enable them right from your dashboard. Optionally, you can allow reviews from verified customers only, and display a label identifying the reviewers as verified.

Keeping You Informed

Selling products is a great start, and with WooCommerce reports, you can track what you’re selling, spot trends, and analyze your data to plan future growth.

  • Store Dashboard – Quickly view your traffic, orders, and status summary from the built-in dashboard.
  • Reports – With WooCommerce reports, you can view your gross and net sales, and print reports.
  • Analyzing – Track your growth trends and sales to help plan the store growth.

Customer Management

From visitor to customer, from customer to repeat client – the Customer Management tools in WooCommerce make it easy for your site visitors to take the next step.

  • Accounts and Passwords – Encouraging your customers to create accounts, and making it easy for them to do so, will help you retain your customers. You can set up your WooCommerce installation to optionally autogenerate passwords, and generate the customer account username from the customer’s email address, making the account creation process flow more smoothly.
  • iOS App – Because your store should go with you! Easily check your product catalog, product details, orders, and more, right from your iOS device.

Easy Mobile E-Commerce

Customers on phones, phablets, and tablets are a growing demographic, and WooCommerce makes sure your customers have a great experience no matter which device they are shopping from.

  • Mobile Friendly – “mCommerce,” or Mobile e-commerce, commands a large portion of online sales, with projected growth increasing astronomically. WooCommerce is mobile-friendly, so that you never miss out on a sale due to your customer’s device.

All of this, and so much more, is bundled right into the core plugin – enough to set up your own e-commerce store right out of the box.

Just in case, though, there are WooCommerce extensions.

Fully Extendable

With WooCommerce extensions, the sky truly is the limit. Over 450 extensions and counting mean that you can configure your shop in virtually limitless ways.

Instead of adding to the core plugin, extensions are add-ons that work only if WooCommerce is installed first, and they add additional functionality to your e-commerce website.

You can grab free and premium extensions from within the WooCommerce shop, and there are many additional plugins that are designed for or compatible with WooCommerce in the WordPress plugin directory.

Woocommerce Subscriptions

Why Should I Use WooCommerce?

Now that we’ve answered “What is WooCommerce?” and “What can WooCommerce do?”, the answer to “Why should I use WooCommerce?” is readily apparent. From ease of use to SEO, control over inventory to mobile readiness, WooCommerce is the clear choice for your WordPress e-commerce site!

Get WooCommerce Tips
+ 5 Easy Ways to Make Your WooCommerce Store Successful

Just getting started with WooCommerce? In this ebook, we cover 5 ways to make more money with WooCommerce.

Woocommerce.com

Download the Free Ebook