WooCommerce Docs

Documentation, Reference Materials, and Tutorials for your WooCommerce products

Search

Configuring WooCommerce Settings

On this page we’re going to walk through all settings available to you in WooCommerce. You’ll find information about General WooCommerce settings as well as Product, Tax, Checkout, Shipping, Accounts, Email, and Webhooks.

To get started, go to WooCommerce > Settings.

General Settings ↑ Back to Top

 

Base Location
Defines your shop’s base country and state (i.e., Where you are based as a seller). It determines default tax rates and customer locations.

Selling Location(s)
Choose to sell to all countries or to specific countries. You can choose multiple specific countries or states.

Shipping Location(s)
Choose to ship to only those countries you sell to, or a subset of countries. You can disable shipping & all shipping-related functionality.

Default Customer Address
Choose the location we assume site visitors are in, before they enter it, to calculate tax and shipping.

  • Shop base address tells the system to assume they are in the same location as your shop.
  • No address gives them no location, and no taxes are calculated.
  • Geolocate address verifies where their current location and calculate taxes accordingly.
  • Geolocate with page caching support is the same as above, but does the geolocation via Ajax. You may notice your website URLs have a ?v=xxxxx appended to them. This is normal to prevent static caching of prices.

Enable Taxes
Enable or disable taxes on your store. Disabling hides tax settings.

Store Notice
Enable site-wide store notice text by selecting the checkbox, then editing your message below. This message displays across the top of your site and can be styled with CSS to fit your theme.

For example, adding the following to your custom CSS will make the background of the Store Notice white:

p.demo_store {background: white;} 

Currency Options

Options that affect how prices are displayed on the frontend.

WooCommerce Currency Options

Currency
Choose the default currency for the store. Only one may be selected.

Currency Position
Choose the default currency position for prices: Left, Right, Left/Right with space

Thousand Separator
Choose the symbol to use for the thousand separator: 1,000 or 1.000

Decimal Separator
Choose the symbol to use for the decimal separator: 100.00 or 100,00

Number of Decimals
Choose how many numbers to display to the right of the decimal when displaying prices: 100.00 or 100

The Style & Scripts settings from earlier versions of WooCommerce are now in their own plugin called WooCommerce Colors, which integrates with the WordPress customizer. Most themes have their own styling, but if you can use our free WooCommerce Colors plugin to choose your own.

Products Settings ↑ Back to Top

 

Settings for products and how they are displayed, including image sizes, inventory and downloadable product settings.

General

In the General sub navigation section, Measurements and Reviews allows you to enter weight and dimensions units for products, and enable/disable ratings on product reviews.

WooCommerce Products > General

Product Ratings

  • Enable ratings on reviews.
  • Ratings are required to leave a review.
  • Show Verified Owner label for customer reviews. A verified owner is a customer who is logged in with their account and has purchased the product.
  • Only allow reviews from verified owners.

Display

WooCommerce Products > Display

Shop Page/Product Archive
Select what page you want to be the default shop page. Need not be the Shop page that WooCommerce installed, or can be skipped if you use another method to display products.

Shop Page Display
Choose to show products, subcategories or both.

Default Category Display
Choose to show products, subcategories or both.

Default Product Sorting
Select to sort products by:

  • Default product sorting (custom ordering + name)
  • Popularity (sales)
  • Average rating
  • Most recent
  • Price (ascending/descending)

Default product sorting (custom ordering + name) - Add the order in which you would like to see the products here.

Any product with the product number 0 will display before 1. By default, all products are assigned 0.

Add to cart behavior

  • Redirect to cart page after successful additionAutomatically takes customer to the cart page upon adding a product.
  • Enable Ajax add to cart buttons on archivesAdds the ‘Add to Cart’ option to shop archive pages.

Product Image Sizes

WooCommerce Products > Product Images

These settings affect the actual dimensions of images saved in your catalog once you upload an image – the display on the frontend will be overridden by CSS styles if applied. If you change these settings, you need to regenerate thumbnails for the new image size settings to be applied.

Options include:

  • Catalog Images
  • Single Product Image
  • Product Thumbnails

If you are having trouble with blurry product images, see: Using the Appropriate Product Image Dimensions.

Inventory Options

To edit your shop’s inventory options, go to: WooCommerce > Settings > Product > Inventory.

WooCommerce Products > Inventory

Choose whether to enable stock management. If selected, you have these options:

  • Hold Stock (minutes)Hold products (for unpaid orders) for X minutes. When limit is reached, the pending order is canceled. Leave blank to disable.
  • Enable low stock notifications
  • Enable out of stock notifications
  • Notification Recipient – Enter email address for notifications.
  • Low Stock Threshold – Number of products to trigger low stock notification
  • Out Of Stock Threshold – Number of products to trigger out of stock status.
  • Out Of Stock VisibilityChoose to hide out of stock items from catalog.
  • Stock Display Format
    • Always show stock – “12 in stock”
    • Only show stock when low – “Only 2 left in stock” vs. “In stock”
    • Never show amount

Downloadable Products

WooCommerce Products > Downloadable Products

File Download Method
Controls how your store provides downloadable files to purchasers.

  • Force Downloads – Files are ‘forced’ to download via a PHP script. Files are not accessible to anyone but purchasers, and direct links are hidden.
  • X-Accel-Redirect/X-Sendfile – Similar to ‘forced’ above, but it has better performance and can support larger files. It requires that your hosting provider supports either X-Sendfile or X-Accel-Redirect, so you need to check with them first.
  • Redirect only – A download URL links the user to the file. Files are not protected from outside access.

Most stores should use one of first two methods to keep files safe from outside access. Redirect should only be used if you encounter problems or don’t mind downloads being non-secure.

Access Restriction

  • Select if downloads require loginDoes not apply to guest purchases.
  • Grant access to downloadable products after paymentEnable to grant access to downloads when orders are Processing, rather than Completed.

Tax Settings ↑ Back to Top

 

Taxes are very important and complex enough that we’ve written more about them in their own section of our docs. More at: WooCommerce Tax Settings.

Shipping Settings ↑ Back to Top

 

Shipping Zones
Shipping Options
Shipping Classes

The main shipping settings screen is for Shipping Zones. Think of a shipping zone as a geographic region where a certain set of shipping methods and their rates apply.

You can read about setting up shipping zones at: Setting up Shipping Zones

Shipping Options

2016-05-18 at 13.29

 

Shipping Calculations

  • Enable the shipping calculator on the cart page
  • Hide shipping costs until an address is entered

Shipping Destination
Ship to billing address by default or only ship to the user’s billing address.

 

Checkout Settings ↑ Back to Top

 

BACS
Cheque
Cash on Delivery
PayPal Standard
PayPal Powered by Braintree
Stripe

Control settings for checkout pages, coupon usage and payment gateways.

Checkout Options

Under the Checkout sub navigation section, there are options for the general checkout process of your store.

2016-05-18 at 13.30

Checkout Process

Coupons
Select to enable the use of couponsCoupons can be applied from the cart and checkout pages.

Calculate coupon discounts sequentially
Changes the coupon calculation logic to apply coupons in sequence on top of one another, rather than basing them on the original product prices.

Checkout Process

  • Enable guest checkoutAllows customers to check out without creating an account.
  • Force secure checkoutForce SSL (HTTPS) on the checkout pages. An SSL Certificate is required, if selected.

Checkout Pages

checkout-pages

Pages need to be set so WooCommerce knows where to send users to check out: Cart Page, Checkout Page, Terms and Conditions. You need not use the pages WooCommerce installed, but you must have a page set for the Cart and Checkout pages. Otherwise your customers cannot buy and pay.

Cart and checkout pages are normally created and set when installing/setting up WooCommerce. If you want to use a Terms and Conditions page, you need to create a new page for them. Then select the page in the settings as shown above.

Checkout Endpoints

checkout-endpoints

Endpoints are appended to page URLs to handle specific actions during the checkout process. They should be unique. Learn more about WooCommerce endpoints.

Payment Gateways

Installed gateways are listed and can be dragged and dropped to control the order in which they display to customers.

More information about:

 Accounts Settings ↑ Back to Top

 

Account Pages

account-pages
Pages need to be set so WooCommerce knows where to send users to access account-related functionality.

My Account Page
Choose a page from the dropdown that you want to use for the My Account page.

My Account Endpoints

myaccount-endpoints

Endpoints are appended to your page URLs to handle specific actions on the accounts pages. They should be unique.

  • Orders
  • View Order
  • Downloads
  • Edit Account
  • Addresses
  • Payment Methods
  • Lost Password
  • Logout

Learn more about WooCommerce Endpoints.

Registration Options

account-registration

Enable Registration

  • Enable registration on the Checkout page
  • Enable registration on the My Account page
  • Display returning customer login reminder on the Checkout page

Account Creation

  • Automatically generate username from customer email
  • Automatically generate customer password

Emails Settings ↑ Back to Top

 

Options to edit email settings and templates.

woocommerce emails

Email Sender Options

Set the ‘From’ name and email address for the sender used in WooCommerce emails.

Email Templates

woocommerce email template

This section lets you customize WooCommerce emails. For more advanced control, copy the woocommerce/templates/emails/ folder to yourchildtheme/woocommerce/emails/.

We recommend keep customizations in a child theme, so changes are not overwritten when performing updates More at: How to set up and use a child theme.

Header Image
Enter the URL of an image you want to show in the email header. You can upload an image via the Add Media button or Media > Add New.

Email and Text

  • Base Color – Color for WooCommerce email templates.
  • Background ColorBackground color for WooCommerce email templates.
  • Email Body Background ColorMain body background color.
  • Email Body Text ColorMain body text color.

Editing Individual Email Templates

woocommerce email options

In the table, you have these email templates:

New order | Cancelled order | Failed orderProcessing order | Completed order | Refunded orderCustomer invoice | Customer noteReset password | New account

Each template has options you can edit:

Enable/Disable
Enable this email notification.

Recipient(s)
Enter recipients (comma separated) for this email. Defaults to info@woocommerce.com.

Subject
This controls the email subject line. Leave blank to use the default subject:

[{site_title}] New customer order ({order_number}) - {order_date}

Email Heading
This controls the main heading contained within the email notification. Leave blank to use the default heading.

Email type
Choose which format of email to send. Options include:

  • Plain Text
  • HTML
  • Multipart

If using Plain Text emails, keep in mind that text fields are limited to 155 characters. If your products have long names and/or numerous variations/add-ons, the field may be truncated.

HTML template
To override and edit this email template, copy woocommerce/templates/emails/admin-new-order.php to your theme folder: yourchildtheme/woocommerce/emails/admin-new-order.php. You can also copy the template file or view it on this setting screen.

API Settings ↑ Back to Top

api-settings

Enable the REST API, as well as create Keys and Webhooks for your apps.

API
Choose to enable the REST API. This API is for developers to use. You can enable it to access store data from outside WordPress, e.g., our iOS app or other external apps. More information at: WooCommerce REST API.

Back to the top