Search

Configuring WooCommerce Settings

On this page we’re going to walk through all the 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 settings. Please note this doc is relevant from WooCommerce 2.3+.

To get started, go to WooCommerce > Settings. Then walk through the documentation below in each section.

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.

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. (as of WC 2.3+)

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;} 

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. To learn more, see: WooCommerce REST API.

Currency Options

Options that affect how prices are displayed on the front-end.

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

Note: The Style & Scripts settings 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/decending)

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

Note: 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 front-end 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 cancelled. 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

WooCommerce Tax > Tax Options

Taxes are complex enough to warrant a separate section that explains how to set them up and how they work. More at: WooCommerce Tax Settings here.

Checkout Settings ↑ Back to Top

BACS
Cheque
Cash on Delivery
PayPal Standard
Simplify Commerce

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

Checkout Options

WooCommerce > Checkout > Checkout Options

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

Checkout Process

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

Checkout

  • 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.
  • Force HTTP when leaving the checkoutForces pages to load over HTTP instead of (SSL) HTTPS. Useful for certain gateways that require this.

Checkout Pages

WooCommerce > Checkout > 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 & Checkout pages. Otherwise your customers cannot buy and pay.

Cart and checkout pages are automatically installed with WooCommerce. If you want a Terms and Conditions page, you need to create your own custom page, then select the page in the settings as shown above.

Checkout Endpoints

WooCommerce > Checkout > 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:

Shipping Settings ↑ Back to Top

 

Shipping Options

WooCommerce Shipping Settings

Shipping Calculations

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

Shipping Display Mode
Display shipping methods with radio buttons or in a dropdown.

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

Restrict shipping to Location(s)
Ship to all countries or specify countries you will not ship to.

Shipping Methods

WooCommerce Shipping Methods

Choose which shipping option is the default, enable and disable methods, and drag and drop to reorder.

Learn more about core shipping settings at: WooCommerce Shipping Documentation

Accounts Settings ↑ Back to Top

Account Pages

WooCommerce > Accounts > Account PagesPages 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

WooCommerce > Accounts > My Account Endpoints

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

  • View Order
  • Edit Account
  • Edit Address
  • Lost Password
  • Logout
Learn more about WooCommerce Endpoints.

Registration Options

WooCommerce > Accounts > Registration Options

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@woothemes.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

Here you can enable the REST API as well as create Keys and Webhooks for your apps. Webhooks in WooCommerce have a nice UI to help manage them. More at: Webhooks.

Back to the top