For WordPress 6.8+ · WooCommerce 9.0+ · PHP 8.1+

Documentation

Set up Tierly in about fifteen minutes: install, activate, add two pages, set your prices.

1. Install

You need WordPress 6.8 or later, WooCommerce 9.0 or later, and PHP 8.1 or later.

Tierly comes in two editions. Free covers wholesale accounts, one wholesale price level, minimums, the order grid and the wholesale catalogue. Pro adds multiple pricing tiers, volume and category pricing, tax-exempt tiers with payment and shipping rules, quick order by SKU, catalogue import and export, the wholesale dashboard with reorder, and your own brand colours. Sections for Pro-only features are marked Pro.

Free: in WordPress, go to Plugins → Add New, search for Tierly, then install and activate it. Until the free edition is listed on WordPress.org, email support@tierlywp.com for the zip and install it as below.

Pro:

  1. Download tierly.zip from the link in your purchase email.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
  3. Click Activate. WooCommerce must already be active.

Upgrading from Free: install and activate the Pro zip the same way. The free version is switched off automatically, and your settings, accounts and prices are kept.

2. Activate your licence Pro

Go to WooCommerce → Tierly. Paste the licence key from your purchase email and click Activate License. The settings and accounts screens appear once the licence is active.

If activation asks you to confirm by email, the message comes from Freemius on behalf of Tierly. Check your spam folder if it hasn't arrived after a few minutes.

The licence turns on automatic updates in the normal Dashboard → Updates screen. If it expires, the plugin keeps working; only updates and support stop.

Staging or local copies of your store: deactivate the licence on one site under WooCommerce → Tierly → Account before activating it on another, or buy a plan with more sites.

3. Create the two storefront pages

Application page

  1. Create a page, for example "Apply for a wholesale account".
  2. Add the B2B Wholesale Registration Form block and publish.
  3. In WooCommerce → Tierly → Settings → Storefront, choose this page as the Application page.

Visitors create an account and apply in one step. Customers who are already logged in apply with their existing account.

Wholesale catalogue page

  1. Create a page, for example "Wholesale catalogue".
  2. Insert the Wholesale catalogue pattern. Add the B2B SKU & CSV Quick-Order Importer block anywhere on the same page if buyers order by SKU Pro. It opens in a popup from the Quick order button in the catalogue bar.
  3. Choose this page as the Wholesale catalogue page under Settings → Storefront. It is linked from My Account and from the approval email.

Buyers can switch the catalogue between a list and a grid; Tierly remembers their choice. The search box filters the catalogue in place: matches on the current page show as they type, and after a short pause the whole catalogue is searched by name, short description and SKU, with page numbers to match. It works with any theme.

4. Set wholesale prices

Tiers

Under Settings → Pricing tiers, each tier has a name and a discount from 0 to 90%. The free edition has one tier, which every approved buyer gets. Pro has as many as you need: the defaults are Silver 10%, Gold 20% and Platinum 30%. Add, rename or remove tiers, and choose the tier new accounts start in.

Discount is calculated from decides whether the percentage comes off the regular price or the current price, including sales. Either way, a wholesale buyer never pays more than the current retail price.

Fixed prices per product

Edit a product. In the General tab, under the regular and sale price, there is a wholesale price field for each tier. For variable products, the fields are on each variation. Leave a field empty to use the tier discount.

Volume pricing Pro

Under Settings → Volume pricing, add rules such as "from 50 units, an extra 5% off". The extra discount comes off the buyer's wholesale price once the cart holds that many units of a product; all sizes and colours of a product count together. Limit a rule to chosen categories, or leave it on all products. The order grid shows the steps and updates prices as the buyer changes quantities.

Category pricing Pro

Under Settings → Category pricing, choose a category and give each tier its own discount there. Leave a box empty to use the tier's normal discount. Parent categories count, so a rule on "Tools" also covers "Tools → Drills". If a product matches more than one row, the first row wins. A fixed wholesale price on the product always comes first.

Tax, payment and shipping Pro

Under Settings → Tax, payment & shipping:

  • Tax-exempt tiers: approved buyers in these tiers are charged no tax.
  • Payment methods: set each method to everyone, wholesale buyers only (optionally chosen tiers), or retail customers only. A common setup is bank transfer or invoice for wholesale buyers only.
  • Shipping methods: the same choices, per shipping method type.

5. Minimum order quantities

  • Per product: the Wholesale minimum (units) field in the product's General tab.
  • Store-wide: Settings → Store-wide minimum order, used for products without their own minimum. 1 means no minimum.

The minimum counts all units of a product, so buyers can mix sizes or colours to reach it. It applies to approved wholesale buyers only, and is checked when items are added and again at checkout, including the block checkout.

If stock is lower than the minimum and backorders are off, the minimum drops to the stock that is left, so the last units can still be sold.

6. Approve accounts

New applications appear under WooCommerce → Tierly → Accounts, with the company name, email and tax ID. Select one or more and choose Approve or Reject or revoke, or use Change pricing tier on a single account.

You receive an email for each new application. Buyers receive an email when they are approved. Both use your WooCommerce email style.

To skip reviewing, turn on Approve new applications automatically. Anyone who applies then gets wholesale prices straight away.

7. Quick order by SKU Pro

Add the B2B SKU & CSV Quick-Order Importer block to the catalogue page, or any page. Only approved buyers see it. On the catalogue page it opens in a popup from the Quick order button in the catalogue bar, and links ending in #quick-order open it too; on other pages it shows in place.

  1. The buyer pastes their list, uploads a CSV file or drops one on the box. There is no line limit: long lists are checked and added in batches, with progress shown.
  2. Review order shows every line with the buyer's own price and a line total. Lines that need attention come first and are marked: below the minimum or over the stock (with a one-click fix such as Use 25), a product with options (pick one from the list), or an unknown SKU.
  3. Add to cart adds the lines that are ready. Anything left stays in the box to fix, and can be downloaded as a CSV.

Accepted formats: SKU, 10, SKU;10, SKU 10, SKU x 10, 10, SKU, tab-separated columns, and spreadsheets with a header row (an SKU column and a quantity column in any order; other columns are ignored). Repeated SKUs are added together, and letter case doesn't matter. Excel files need saving as CSV first.

8. Catalogue import and export Pro

Under WooCommerce → Tierly → Import / export.

Export downloads a CSV with every product and option: SKU, name, type, parent SKU, regular price, sale price, stock, minimum order and one price column per tier. It opens correctly in Excel and Google Sheets.

Import updates products by SKU:

  1. Choose the CSV. Columns are matched automatically, including common supplier names such as "Item Code", "On hand" or "Gold price". Change any match, or ignore a column.
  2. Click Check changes. Nothing is saved yet: you see every change as old value → new value, plus any rows with problems.
  3. Click Save changes.
In a cellResult
EmptyLeaves the value as it is
A numberSets it. Currency symbols are ignored; 1,234.50 and 42,50 are both read correctly
-Removes a sale price, minimum or tier price. Removing stock switches stock tracking off

Prices and stock go on each option of a variable product; minimums go on the main product. Rows that break these rules, unknown SKUs and sale prices above the regular price are reported, not saved.

9. Storefront options

SettingWhat it does
Show the order grid on product pagesAdds the bulk order grid under the add-to-cart button for approved buyers.
Invite other shoppers to applyShows a short invitation with a link to your application page on product pages. Needs an application page.
Hide prices from visitors who are not logged inReplaces prices with a log-in link and stops logged-out visitors adding to the cart.
Button colour ProColour of Tierly's buttons and highlights. "Theme" uses your theme's brand colour. Text colour is chosen automatically so it stays readable. The free edition uses Charcoal.
Catalogue header ProDark, light, or your button colour, for the bar at the top of the wholesale catalogue. The free edition uses dark.
Recent orders on the Wholesale tab ProHow many past orders the Wholesale tab in My Account lists (10 by default). When a buyer has more, a "View all orders" link opens their full order history.
Reorder button in My Account → Orders ProOn by default. Approved buyers get a Reorder button next to each past order, which puts its items back in the cart and opens the cart.
Label for the tax ID fieldFor example "VAT number", "EIN" or "PAN".
Delete all plugin data when the plugin is deletedOff by default. When on, deleting the plugin removes its settings, account data and product fields.

10. Change the layout from your theme

Like WooCommerce, Tierly lets your theme override its layouts without editing the plugin, so your changes survive updates.

  1. Create a folder called tierly in your theme (use a child theme if you didn't build the theme yourself).
  2. Copy the file you want to change from wp-content/plugins/tierly/templates/ into it, keeping the same sub-folder.
  3. Edit your copy. Tierly uses it instead of its own.
TemplateWhat it shows
blocks/order-grid.phpThe wholesale order grid on catalogue and product pages
blocks/sku-importer.php ProThe order-by-SKU and CSV box
blocks/application-form.phpThe wholesale application form
myaccount-wholesale.php ProThe Wholesale tab in My Account

Keep the data-wp-… attributes in your copy: they connect the layout to Tierly's buttons and totals. Each template lists the variables it can use at the top of the file.

For colours only, you don't need a template: in Pro, use Settings → Appearance.

11. For developers

Filters and actions you can use in your theme or a small plugin:

HookUse
tierly_wholesale_priceChange the wholesale price for a product and buyer.
tierly_min_order_qtyChange the minimum for a product.
tierly_validate_registrationAdd a check to applications, such as a CAPTCHA. Return a WP_Error to reject.
tierly_registration_rate_limitApplications allowed per hour from one address (default 5).
tierly_application_recipientWho receives new-application emails.
tierly_new_wholesale_application (action)Runs when someone applies.
tierly_account_status_updated (action)Runs when an account is approved, rejected or set back to pending.
tierly_template_pathFolder name inside the theme for template overrides (default tierly).
tierly_locate_templateChange which file is used for a template.
tierly_tiersChange the list of pricing tiers in use.
tierly_appearance_varsChange the CSS variables Tierly prints for its colours.
tierly_grid_replaces_cart_formReturn false to keep the standard add-to-cart form next to the order grid.

Stuck? Email support@tierlywp.com with your WordPress, WooCommerce and Tierly versions.