Getting started #
- Upload the zip under Plugins → Add New → Upload Plugin (or copy the
tribe-labelsfolder intowp-content/plugins/) and activate tribeLabels. - Open Print Labels in the FluentCart or WooCommerce menu. In FluentCart’s own menu bar, and in FluentHub under Commerce, it’s under More.
- Enter your licence key on the Licence tab and choose Activate.
- A default template is already set up for you: Avery L7160 compatible on A4 stores, Avery 5160 compatible on Letter stores.
- Do a test print on plain paper first. Hold it against a label sheet up to the light. The test print includes a line that should measure exactly 100 mm. If it doesn’t, your printer is scaling the page.
The one setting that matters In your browser’s print dialog, set Scale to 100% (or “Actual size”), turn headers and footers off, and choose the paper size shown on the preview. Nearly every misaligned label comes down to one of these three.
Printing labels #
The Print tab works top to bottom in three steps.
1. Orders #
Choose the order status and shipping status, then Find orders. The tab tells you how many orders match.
More filters narrows things further:
- product (start typing a name or SKU)
- order date range
- digital-only orders, which are skipped unless you include them
To print only some of the matches, use Choose individual orders and tick the ones you want (the first 500 matches are listed).
Up to 5,000 matching orders are found at a time, oldest first.
2. Label #
- Template picks the label sheet and layout. Your default template is already selected.
- Start at label is for a partly used sheet. Leave it at 1 for a new sheet; set it to 4, say, if the first three labels have gone.
- Show label outlines draws the label edges, which is handy for a trial run on plain paper.
3. Print #
Preview and print opens a preview in a new tab; print from there. Large runs print in batches of up to 500 orders, each batch opening in its own tab.
- Labels outlined in red on the preview have more text than fits. Trim the template or reduce the font size.
- Orders with no address get no label. The preview tells you which ones were left out.
Or print from the order itself #
- Every order screen has a box with links to print that order’s labels.
- In WooCommerce, the orders list has a Print Labels bulk action.
Templates #
Templates live on the Templates tab. Each one sets the label sheet, what’s printed on it and how it looks. One template is the default, and any template can be test printed.
One label per… #
- order: the usual choice for shipping
- order line: one label for each product in the order
- unit: a quantity of 3 prints 3 labels
Label sheets #
These sheets are built in, all Avery compatible:
| Sheet | Paper | Labels per sheet | Label size (mm) |
|---|---|---|---|
| L7159 | A4 | 24 | 63.5 × 33.9 |
| L7160 | A4 | 21 | 63.5 × 38.1 |
| L7161 | A4 | 18 | 63.5 × 46.6 |
| L7162 | A4 | 16 | 99.1 × 33.9 |
| L7163 | A4 | 14 | 99.1 × 38.1 |
| L7165 | A4 | 8 | 99.1 × 67.7 |
| L7173 | A4 | 10 | 99.1 × 57 |
| 5160 | Letter | 30 | 66.7 × 25.4 |
| 5161 | Letter | 20 | 101.6 × 25.4 |
| 5162 | Letter | 14 | 101.6 × 33.9 |
| 5163 | Letter | 10 | 101.6 × 50.8 |
| 5164 | Letter | 6 | 101.6 × 84.7 |
Using something else? Choose Custom size and enter the page size, columns, rows, label size, margins and gaps in millimetres.
What goes on the label #
Write the label as plain text, with placeholders in square brackets. This template:
[shipping_address]
Order #[order_number] · [total_qty] items
prints something like:
Sam Sample
1 Example Street
Sampletown
AB1 2CD
Order #1042 · 3 items
Three options keep labels tidy:
- Remove empty lines. A line whose placeholders are all empty is dropped, so a missing company name doesn’t leave a gap.
- Keep line breaks. Your line breaks are printed exactly as you typed them.
- Hide the home country. The country is left off addresses in your store’s own country.
Address placeholders #
Each one comes in a shipping_ and a billing_ version.
| Placeholder | Prints |
|---|---|
[shipping_address] | The full address |
[shipping_name] | Name |
[shipping_first_name] | First name |
[shipping_last_name] | Last name |
[shipping_company] | Company |
[shipping_address_1] | Address line 1 |
[shipping_address_2] | Address line 2 |
[shipping_city] | Town or city |
[shipping_state] | State or county |
[shipping_state_code] | State code |
[shipping_postcode] | Postcode or ZIP |
[shipping_country] | Country |
[shipping_country_code] | Country code |
[shipping_phone] | Phone |
Order placeholders #
| Placeholder | Prints |
|---|---|
[order_number] | Order number |
[receipt_number] | Receipt or invoice number |
[order_date] | Order date |
[order_total] | Order total |
[customer_note] | Customer note |
[email] | Customer email |
[items] | Items with quantities |
[items_sku] | Items with quantities and SKUs |
[sku_list] | SKUs only |
[total_qty] | Total quantity |
[meta:your_key] | Any order meta value (replace your_key with the meta key) |
Per-line and per-unit placeholders #
For templates that print a label per order line or per unit:
| Placeholder | Prints |
|---|---|
[item_name] | Item name |
[item_sku] | Item SKU |
[item_qty] | Item quantity |
[unit_count] | Which unit this is, e.g. “2 of 3” |
Store placeholders #
| Placeholder | Prints |
|---|---|
[site_title] | Site title |
[date] | Today’s date |
Appearance #
Choose the font (sans-serif, serif or monospace), font size, padding, and horizontal and vertical alignment. For anything else, use the Custom CSS box.
Labels not lining up? #
| What you see | What to do |
|---|---|
| Labels drift further out of line down the page | The browser is scaling. Set Scale to 100% / Actual size. The 100 mm line on the test print will confirm it. |
| Every label is off by the same amount | Use Printer adjustment on the template to move everything right or down. |
| A label is outlined in red on the preview | Too much text. Shorten the template or reduce the font size. |
| An order didn’t get a label | It has no address, or it’s digital-only (skipped by default). The preview lists orders left out. |
| Headers, URLs or page numbers printed on the sheet | Turn off headers and footers in the print dialog. |
Switching from WooCommerce Print Address Labels #
If the site has templates from WP Overnight’s WooCommerce Print Address Labels plugin, the Templates tab shows an Import templates button.
Imported templates are laid out to print within about 1 mm of where they printed before. Your existing tribeLabels templates aren’t touched, and importing again simply adds fresh copies. As always, do a test print before using an imported template on real labels.
A few placeholders from that plugin have no tribeLabels equivalent yet. They print nothing, and the import tells you which templates use them:
- order weight, order time and shipping method
- QR codes and order or product barcodes
- product prices, weight and image
Your licence key #
tribeLabels needs an activated licence before it will print. Until a key is activated, Print Labels shows only the Licence tab.
- Open Print Labels → Licence. Only administrators see this tab.
- Paste the key from your tribetools.pro account and choose Activate.
- The Print and Templates tabs appear, and the print links show on your order screens.
Updates then arrive on the Plugins screen like any other plugin. Check Update under tribeLabels there looks for one straight away.
Signed updates #
Every tribeLabels update is signed by tribeTools. Before an update installs, the plugin checks the signature and that the file is the one that was signed, and refuses the update if either check fails. Your site stays on the version it has.
A zip you upload yourself under Plugins → Add New → Upload Plugin is not checked, so only install zips downloaded from your tribetools.pro account.
Renewing #
When your licence is due, use Renew licence on the Licence tab to keep receiving updates. An expired licence can’t be activated again until it’s renewed.
Moving the site #
Choose Deactivate on this site first, then activate again at the new address, so the licence isn’t counted twice. tribeLabels stops printing on the old address as soon as it’s deactivated.
If tribetools.pro can’t be reached #
Nothing changes. tribeLabels keeps the licence status it last heard, so a store outage never stops a label run.
Who can print #
| Cart | Print labels | Manage templates |
|---|---|---|
| FluentCart | Anyone with FluentCart’s permission to view orders | Anyone with FluentCart’s permission to manage orders |
| WooCommerce | Anyone who can edit orders or manage WooCommerce | Anyone who can manage WooCommerce |
The Licence tab is for administrators only, in either cart.
For developers #
Filters #
| Filter | Changes |
|---|---|
tribe_labels/presets | The built-in label sheets |
tribe_labels/placeholder_reference | The placeholder list shown in the template editor |
tribe_labels/placeholder_values | The values placeholders print for an order |
tribe_labels/address_format | How a full address is laid out |
tribe_labels/label_html | The finished HTML of a label |
tribe_labels/adapters | The carts tribeLabels works with |
Uninstalling #
Deleting the plugin removes its templates and the stored licence key from the database. It stores nothing else.
Deleting does not free the licence’s activation for this site. Deactivate on the Licence tab first, or remove the site in your tribetools.pro account.

