---
title: tribeLabels Documentation
description: "## Getting started 1. Upload the zip under **Plugins → Add New → Upload Plugin** (or copy the `tribe-labels` folder into `wp-content/plugins/`) and activate **tribeLabels**. 2. Open **Print Labels** in the FluentCart or WooCommerce menu. In FluentCart's own menu bar, and in FluentHub under **Commerce**, it's under **More**. 3. Enter…"
url: "https://tribetools.pro/docs/tribelabels-documentation/"
updated: "2026-11-16"
category: tribeLabels
---

# tribeLabels Documentation

## Getting started

1. Upload the zip under **Plugins → Add New → Upload Plugin** (or copy the `tribe-labels` folder into `wp-content/plugins/`) and activate **tribeLabels**.
2. Open **Print Labels** in the FluentCart or WooCommerce menu. In FluentCart's own menu bar, and in FluentHub under **Commerce**, it's under **More**.
3. Enter your licence key on the **Licence** tab and choose **Activate**.
4. A default template is already set up for you: Avery L7160 compatible on A4 stores, Avery 5160 compatible on Letter stores.
5. **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.

1. Open **Print Labels → Licence**. Only administrators see this tab.
2. Paste the key from your tribetools.pro account and choose **Activate**.
3. 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.
