Documentation
Set up Tierly in about fifteen minutes: install, activate, add two pages, set your prices.
- Install
- Licence
- Pages
- Pricing
- Minimums
- Accounts
- Quick order
- Import / export
- Storefront
- Templates
- Developers
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:
- Download
tierly.zipfrom the link in your purchase email. - In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
- 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.
3. Create the two storefront pages
Application page
- Create a page, for example "Apply for a wholesale account".
- Add the B2B Wholesale Registration Form block and publish.
- 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
- Create a page, for example "Wholesale catalogue".
- 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.
- 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.
- 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.
- 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.
- 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:
- 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.
- Click Check changes. Nothing is saved yet: you see every change as old value → new value, plus any rows with problems.
- Click Save changes.
| In a cell | Result |
|---|---|
| Empty | Leaves the value as it is |
| A number | Sets 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
| Setting | What it does |
|---|---|
| Show the order grid on product pages | Adds the bulk order grid under the add-to-cart button for approved buyers. |
| Invite other shoppers to apply | Shows 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 in | Replaces prices with a log-in link and stops logged-out visitors adding to the cart. |
| Button colour Pro | Colour 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 Pro | Dark, 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 Pro | How 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 Pro | On 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 field | For example "VAT number", "EIN" or "PAN". |
| Delete all plugin data when the plugin is deleted | Off 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.
- Create a folder called
tierlyin your theme (use a child theme if you didn't build the theme yourself). - Copy the file you want to change from
wp-content/plugins/tierly/templates/into it, keeping the same sub-folder. - Edit your copy. Tierly uses it instead of its own.
| Template | What it shows |
|---|---|
blocks/order-grid.php | The wholesale order grid on catalogue and product pages |
blocks/sku-importer.php Pro | The order-by-SKU and CSV box |
blocks/application-form.php | The wholesale application form |
myaccount-wholesale.php Pro | The 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:
| Hook | Use |
|---|---|
tierly_wholesale_price | Change the wholesale price for a product and buyer. |
tierly_min_order_qty | Change the minimum for a product. |
tierly_validate_registration | Add a check to applications, such as a CAPTCHA. Return a WP_Error to reject. |
tierly_registration_rate_limit | Applications allowed per hour from one address (default 5). |
tierly_application_recipient | Who 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_path | Folder name inside the theme for template overrides (default tierly). |
tierly_locate_template | Change which file is used for a template. |
tierly_tiers | Change the list of pricing tiers in use. |
tierly_appearance_vars | Change the CSS variables Tierly prints for its colours. |
tierly_grid_replaces_cart_form | Return 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.