1. WooCommerce Product Sample
  2. Getting Started

2. WooCommerce Product Sample plugin settings

Once you have installed WooCommerce Product Sample on your WordPress site, the next step is to configure the global options. These control how the product samples work throughout your store. You can override these for individual categories, products and variations if required.

Go to WooCommerce → Settings → Products → Product Samples. As well as activating your license key, go through the settings and configure them as needed.

Enable sample for all products

Tick this box if you would like to offer samples for ALL the products in your store. If you only want to offer samples for certain products then you should leave this blank and enable samples for individual categories or products instead.

Sample price number field

Use this field to set a price for all your product samples. To offer free samples, you can either leave this blank or enter 0. To charge for samples, enter the cost e.g. 4.99.

Button text

By default, the button for adding product samples to the cart contains the text 'Order Sample: {price}'. Use the button text option to change this.

For example, you might change it to something like:

  • "Order sample for {price}
  • "Order Free Sample"

If the sample is free and you are using the the {price} merge tag then it will appear as $0.00 (depending on your store's currency). If you don't require this then you can remove the {price} from the button text.

Enable on shop/category pages

By default, the 'Order Sample' button will only appear on the single product page. Enable this option to also display it directly on the product listing pages in your store, such as the main Shop page and product category pages.

Maximum sample quantity

By default, customers can order as many product samples as they like. Enter a whole number here to restrict the maximum number of samples that can be ordered.

For example, if you are offering free samples then it makes sense to add a restriction in order to manage your costs.

Maximum quantity logic

Use this dropdown to choose how the maximum sample quantity (if set) will be calculated:

  • Set a maximum number of samples per order (the default) - This restricts the total number of product samples that each order can contain. For example, if you set a maximum of 5 then customers can order any combination of 5 samples, whether this is of the same product or different products.
  • Set a maximum number of samples per category - This restricts the number of samples that can be ordered per category. For example, if the maximum is 5 then customers can order up to 5 samples from multiple categories in the same order.
  • Set a maximum number of samples per product/variation - This restricts the number of samples that can be ordered of each individual product or variation. For example, if the maximum is 5 then customers can order up to 5 samples of a simple product. For a variable product, they could order up to 5 variations for that particular product, as well as up to 5 samples of other products.

Cart/checkout text

WooCommerce Product Sample will display 'Sample - ' before the product name in the cart, checkout, order confirmation page, and in order-related emails. You can change this to any other text, or delete it completely.

If you want to display the 'Sample' text after the product name, then you can do this by adding the {name} placeholder to the 'Cart/checkout text'. This will display the product name in whichever position you add the placeholder, giving you extra control over this field. For example:

  • If you enter "Sample -" then this text will appear before the product name (regardless of whether or not you use the {name} placeholder).
  • If you enter "{name} - Sample" then the text will appear after the product name.

Shipping class for product samples

If required, then you can choose a shipping class which will be used for product samples. For example, this allows you to charge a different shipping amount (or offer free shipping) for samples, without affecting the postage costs for your other products.

Before doing this, you need to set up your shipping classes in WooCommerce → Settings → Shipping → Shipping classes. If needed, refer to the official WooCommerce shipping classes documentation.

Tax class for product samples

If required, then you can choose a tax class which will be used for product samples. For example, this allows you to charge different tax rates amount (or set zero VAT) for samples, without affecting the tax settings for your other products.

Before doing this, you need to set up tax classes in WooCommerce → Settings → Tax. If needed, refer to the official documentation on setting up taxes in WooCommerce.

Next steps

Once you have configured the plugin settings and clicked the Save button, the 'Order Sample' buttons will start appearing in your store immediately.

But before you finish, the plugin has some additional features which you may wish to set up:

Related Articles

If searching the knowledge base hasn't answered your question, please contact support.