Skip to content

Add Print Template ​


Table of Contents ​


1. Features ​

Creating a template happens in two steps: first decide what the template is, who it belongs to, and what size paper it prints on, then edit the actual layout content. A preview stays visible on the right the whole time, so you see the result the moment you change a line — no need to save and print a test copy just to check. You don't have to start from a blank page either — the system pre-fills the default layout for that type, and you edit from there.

Add Print Template - Page Overview

Quick jump: Choose a Template Type | Step 1: Basic Info | Step 2: Layout Content | Case Counts | Save

1.1 Choose a Template Type ​

Clicking New on the list page first shows Select Template Type. Only after you choose one do you reach the form, because the fields you can fill in differ by type — and the type can't be changed once chosen. If you pick the wrong type, the only option is to delete it and create a new one. See Template Types for what each type is for.

When the currently selected warehouse uses virtual storage locations, Shelf Label won't appear in the list of types you can choose.

The two picking list types (Picking List (Paper), Picking List (App)) correspond to the printed detail sheet of paper picking and of App picking respectively — choose according to the picking method you want to customize. The paper type is one template that covers both "by shelf" and "by product" detail rows; the system decides which one prints from the picking list's status and whether the route walked can be reconstructed, so you cannot choose it and do not need to predict it, and there is no way to pick the wrong type. See Picking List Detail for when each case prints and what it contains.

1.2 Step 1: Basic Info ​

Fields marked with * are required

FieldHow to Fill InNotes
*Template NameGive it a name you can recognize at print time, for example "Brand A Packing Slip (Website)"Parcel Slip and the two picking list types allow up to 255 characters; Parcel Slip, Shelf Label, Custom Shipping Label, and the two picking list types cannot share a name within the same scope
OwnerChoose Merchant Level for a single merchant to use, or Organization Level for the whole organization to shareOnly Parcel Slip and the two picking list types let you choose between both levels; other types have a fixed level and this option won't appear
*MerchantAppears only for Parcel Slip and the two picking list types when you choose Merchant Level; choose which merchant this template servesOnly merchants you're authorized to manage can be chosen. The other merchant-level kinds (Fulfillment Detail, Product Label) do not show this field — ownership is simply the merchant you currently have selected, and if none is selected yet the page asks you to pick one before showing the form
Set as defaultTurning this on means documents at this level with no specified template will use itThe switch's label changes to that merchant's default or the organization default depending on the level; Fulfillment Detail and Custom Shipping Label have no concept of a default, so this switch won't appear; the two picking list types have no applies-to target to specify, so setting a default is the only way they get used automatically
Applicable ChannelsChoose which channels' documents should use this templateOptional. If you leave it empty, this template won't be applied automatically (the summary above this field warns you), and you can specify channels later on the edit page. Fulfillment Detail has no default to fall back on, so specifying channels is its only way of taking effect automatically; Parcel Slip can also take effect through a default. Only merchant-level templates can bind to channels, so the field is hidden when the level is Organization Level, and any channels you already picked are cleared — switch back to Merchant Level and you have to pick them again. Only channels under this template's own merchant are selectable
Applicable Shipping TypesChoose which custom shipping types' shipping labels should use this templateOnly Custom Shipping Label has this field. Optional; the same binding can also be set on the Shipping Types page
*Paper SizePick a common paper size, or enter the width and height in millimeters directlyYou can still adjust the numbers by hand after picking a paper size; width and height must be greater than 0, and the inputs accept 1mm at the lowest. The two picking list types start at A4 (210×297mm) when you create one, and you can only pick A4 or A5 as a common size. Shelf Label offers no common paper sizes to pick from — enter the numbers directly; its width is limited to 20–300mm and height to 15–300mm
When content exceeds the paperWhat happens when the content is taller than the paper: Clip the overflow (the overflow is not printed) or Print on the next sheet (the overflow continues onto the next sheet)Sits below the paper size fields and is available only for Product Label, Shelf Label, and Custom Shipping Label; Product Label and Shelf Label default to Clip the overflow, and Custom Shipping Label defaults to Print on the next sheet. Shelf Label has a fixed paper size: with Print on the next sheet, the overflow continues cleanly onto the next sheet only when you print a single shelf. When you print several shelves in one job, the overflow prints on top of the next label and the whole batch is unusable. When you print several per A4 sheet, each cell's content is always trimmed regardless of this option. Fulfillment Detail, Parcel Slip, and the two picking list types are flowing documents where running past one page is normal, so they have no such option. The preview on the right follows the option you pick

Product Label doesn't specify what it applies to here — that's done one by one on each product's record instead (see Edit Product), so this page only shows a single line explaining that. The two picking list types have no applies-to target to specify, so no related fields appear on this page.

The two picking list types always leave a 10mm margin on all four sides of every page, and a template cannot adjust it; page margin rules written inside the template do not take effect. The preview on the right leaves the same margin around the content, but the preview is one continuous view and does not show page breaks; in actual printing, every page has this margin on all four sides.

The hint below the fields tells you in real time under what conditions this template will be used once it's created. When it shows the yellow hint about not being set as a default and having no applies-to target, this template won't take effect automatically once created. Of the seven types, only Product Label and Shelf Label can be picked manually at print time; the other five will never be printed while in this state.

Click Next once you're done to move to the next step; if a required field is missing, you'll stay on this step with that field flagged.

1.3 Step 2: Layout Content ​

ToolPurpose
Start from a built-in layoutShelf Label offers four ready-made layouts: Big Text + Barcode, Big Text + QR Code, Detailed, and Product Info. Picking one directly overwrites the current content and size. Other types only have one default layout, so this menu isn't shown
Edit HTMLOpens the editor to modify the layout. The preview on the right updates as you go
View VariablesView which fields are available for this type (such as order number, recipient, product name) and the correct way to write them
AI AssistantDescribe the layout you want in a conversation, and the system rewrites the content for you. Only available for Fulfillment Detail
Load Product DataFor Product Label only: pick a real product as the preview sample, to confirm long names and long specs don't break the layout. Click Reset to Sample Data to switch back to the sample data
DescriptionEnter a note about the purpose, for example "For website channel only, includes return policy", to help you tell apart similar-looking templates in the list later

Until you pick a real product, the preview uses the sample data the system provides — not a real order or product.

Variables of the picking list types ​

The two picking list types do not offer exactly the same variables; go by what View Variables lists. A few things are easy to confuse:

  • Status has two variables with different purposes: picking_list.status is the machine value and is only ever processing, done, or terminated — use it to switch content by status, for example {% if picking_list.status == "processing" %}. picking_list.status_label is the display text already translated into the print language; use it only to print, and never compare against it — it stops matching as soon as the print language changes. The column title "Status" is labels.status. Both built-in layouts print the status in the header.
  • The built-in checkbox prints only while the status is processing: the built-in layout tests picking_list.status == "processing"; a done or terminated list prints without checkboxes so it does not look like work that has not been done. If your custom template keeps checkboxes, use the same test.
  • One paper template covers two kinds of detail rows, split by picking_list.by_shelf: when by_shelf is true there is one row per shelf, so a product split across two shelves becomes two rows, each with its own shelf and quantity (item.location, item.quantity), and the quantity column is headed with labels.quantity ("Qty"); when it is false there is one row per product (nothing is filtered out, so products that were not picked at all are included), carrying both the required quantity item.quantity and the net picked quantity item.picked_quantity — no item.location, item.slot_allocations or box-count variables — and the built-in template prints two side-by-side columns headed with labels.required_quantity ("Required Qty") and labels.picked_quantity ("Picked Qty"). The system decides which one appears (see Picking List Detail), so a custom paper template has to handle both; if you only write the by-shelf form, the shelf and quantity columns come out blank on a by-product list. Picking List (App) has no by_shelf: it always has one row per product and never splits by shelf. Total items and total pick quantity are summed per product, not per detail row; picking_list.total_quantity is always the sum of required quantities and picking_list.total_picked_quantity is always the sum of picked quantities — neither changes meaning with the status or the layout.
  • The preview can switch the status of its sample data: the switcher at the top right of the preview defaults to "In Progress · By Shelf" (status is processing, by_shelf is true); Picking List (Paper) can also switch to "Done · By Shelf" and "Done · By Item (Picked)" (by_shelf is false), and Picking List (App) can switch to "Done", "In Progress · No Custom Attributes" and "Done · No Custom Attributes" (the last two show the merchant having no custom inventory attributes, so the whole attributes column collapses). After changing fields or conditions, switch through every option to check that each branch is right and that a done list without checkboxes looks correct.
  • Box-count variables exist only in Picking List (Paper), and only have values in the by-shelf form: product.small_quantity_per_large_unit (items per case), product.large_unit_name, product.small_unit_name, large_unit_quantity (whole cases), remainder_small_unit_quantity (loose pieces); Picking List (App) does not have them. In a template you write them as item.product.large_unit_name and item.large_unit_quantity. They are converted from "this row's quantity", so a product split across two shelves is calculated separately for each row. When a product has no units-per-box filled in (or 0), the full-box count is blank and the loose-unit count is the whole quantity of that row; when the quantity is less than one box, the full-box count is 0 and it prints as 0, not blank. To tell whether a product has a units-per-box value, check whether the full-box count (large_unit_quantity) has a value — do not use product.small_quantity_per_large_unit, which prints 0 as-is when units-per-box is stored as 0. Unit names are blank too when not filled in — the system does not fill in "box" or "piece" for you, so add default text in the template if you need it.
  • The built-in layout does not print box counts: the system's built-in layout stays as it was, with no box-count column. To print them, create a new Picking List (Paper) template and change the quantity cell of the by-shelf branch of the built-in layout it starts from so it prints box counts; the built-in layout has a comment above the quantity column showing how.
  • Picking slot numbers exist only in the by-shelf form of Picking List (Paper): item.slot_allocations is an array; in each entry slot_number is the picking slot number (the fulfillment's number within the wave and the cart position) and quantity is how many of this row's units go into that slot, in placement order (oldest demand first, not by slot number); only consecutive entries for the same slot are merged, so a slot number can appear twice. Write it as {% for slot in item.slot_allocations %}{{ slot.slot_number }}: {{ slot.quantity }}{% endfor %} and use labels.slot ("Slot") for the column title. How the units are split is described in Picking List Detail; shipped fulfillments are not listed, so the sum can be lower than the row's quantity. By-shelf rows reconstructed from what was actually picked on a done list have an empty array; the by-product form and Picking List (App) do not have this variable. The built-in layout already prints this column after the quantity column; custom templates you created earlier do not gain it automatically, so add it yourself if you need it.
  • The built-in layouts print the manufacturing date under the expiration date: both built-in layouts add a manufacturing date line right under each item's expiration date line, printed only when that stock has a manufacturing date. Custom templates you created earlier do not gain this line automatically; to print it, add it yourself with item.manufacturing_date (format YYYY-MM-DD, empty when there is none) and use labels.manufacturing_date ("Manufacturing Date") for the caption. A new template starts from the built-in layout, which already includes the line.
  • Barcode area: the barcode in the header is the wave number the picking list belongs to (or the picking list number when it has no wave), and it is what the floor scans for allocation.

1.4 Fulfillment Detail: Printing Case Counts ​

For merchants who ship by the case, as long as a product has "Items Per Large Unit (Box Quantity)" filled in, the Fulfillment Detail can print "X cases and Y pieces" — there is no need to set up an ordering unit product by product. The built-in default layout does not print case counts, so add the fields to your own layout: open View Variables, find the fields below under "Order Items", and copy the syntax into the layout.

FieldContents
Items per case (product.small_quantity_per_large_unit), large unit name (product.large_unit_name), base unit name (product.small_unit_name)The "Items Per Large Unit (Box Quantity)", "Large Unit Name" and "Base Unit Name" filled in on the product
Whole cases (large_unit_quantity)How many full cases the quantity shipped on this fulfillment fills
Loose pieces (remainder_small_unit_quantity)The base units not packed into a full case; for a product without items per case, the whole shipped quantity

For a product with 4 per case: shipping 10 prints 2 cases 2 pieces; shipping 8 prints 2 cases 0 pieces; shipping 3 prints 0 cases 3 pieces.

  • Calculated from this fulfillment's quantity: when an order is split across several fulfillments, each one is calculated from its own shipped quantity; on a merged fulfillment, each item uses its own product's items per case. Fulfillments created from stock transfers and work orders work the same way.
  • Reads the product's current data: if the product's items per case is changed later, reprinting an existing fulfillment shows the new case count. The ordering-unit fields (ordering unit name and quantity) are a snapshot from when the order was placed and are not affected; both sets of fields can be printed together.
  • Everything counts as loose when items per case is not filled in: if a product's items per case is empty or 0, whole cases prints blank and loose pieces is the whole shipped quantity, while all other fields and the fulfillment itself are produced as usual. This means a layout can drop the quantity column and show only whole cases and loose pieces without any row coming out empty.
  • To tell whether a product has items per case: use whole cases (large_unit_quantity), which is blank when it is not filled in. Do not use product.small_quantity_per_large_unit — if items per case is stored as 0, that field prints 0 as is.

In the preview's sample data, the first item shows 2 cases 2 pieces and the second item shows a product without items per case (whole cases blank, loose pieces equal to the whole shipped quantity).

1.5 Save ​

Clicking Save and Add Another saves the template and clears the form, keeping you on this page to create the next one — handy when you need to build several at once. Submitting normally saves the template and takes you to its detail page.

Before submitting, the system checks the layout content: Fulfillment Detail must keep the picking barcode variable, or the warehouse won't be able to scan the barcode. For every type, a syntax error in the layout blocks submission and the error is pointed out. The two picking list types are checked for syntax only, not for the barcode area: you can still save without it, but scanning the paper on the floor will find no record, so keep it when you rework the layout.


2. FAQ ​

Quick jump: FAQ | Notes

2.1 FAQ ​

▪ I picked the wrong template type — can I change it? ​

No. The type determines which fields you can fill in and which layout fields are available, and it can't be changed after creation — delete it and create a new one instead.

▪ Why can't I see Owner or the default switch for some types? ​

Both are determined by the template type. Only Parcel Slip and the two picking list types let you choose the level; Fulfillment Detail and Custom Shipping Label have no concept of a default, so the default switch doesn't appear for them. See Template Types for the differences between types.

▪ I already chose Applicable Channels — can I also set this as the default? ​

No. A template only takes effect one way — once you specify what it applies to, you can't also set it as the default, and vice versa.

▪ I picked A4 for the paper size, but I want it slightly narrower? ​

The paper size menu is just a shortcut to fill in width and height — after picking one, you can edit the numbers directly, no need to switch to a different mode. On the list page, the size column shows the paper name when the numbers exactly match a common size, otherwise it shows the dimensions in millimeters.

▪ A yellow "content exceeds the paper size" notice appears on the preview — what does it mean? ​

The layout is taller than the paper you set. The notice tells you by roughly how many millimeters and what will happen when printing: with Clip the overflow it says the content "will be clipped when printed", and with Print on the next sheet it says it "will print on the next sheet". Shelf Label shows a different message: its paper size is fixed, so the notice says the overflow will print on top of the next label when several shelves are printed in one job. It is a heads-up and does not block saving. To make it go away, adjust the layout or use a larger paper size, or pick the other option. Fulfillment Detail, Parcel Slip, and the two picking list types never show this notice, because running past one page is normal for them.

▪ It says the name is already in use after I submit? ​

Parcel Slip, Shelf Label, Custom Shipping Label, and the two picking list types don't allow duplicate names within the same scope — just choose a different name.

▪ Can I adjust the margins of a picking list template? ​

No. The two picking list types always use 10mm on all four sides of every page, and page margin rules written inside the template do not take effect; for space inside the content itself, use spacing within the layout.

▪ I can't find a merchant in the Merchant dropdown? ​

It only lists merchants you're authorized to manage. If you can't find one, contact your administrator to check your authorized scope.


2.2 Notes ​

⚠️ Important ​

  • The template type can't be changed once created.
  • Turning on the default switch and saving immediately un-sets the previous default in the same scope — that merchant's documents will then print with the new layout.
  • Start from a built-in layout directly overwrites content and size you've already edited — picking it partway through your edits will lose your changes.

💡 Tip: Product Label layouts are most likely to break on long product names or long specs. Before saving, use Load Product Data to check with the product that has the longest name — it's the safest way to be sure.


FeatureDescriptionLink
Print TemplatesReturn to the list to view all templatesGo
Print Template DetailView the layout of the template you just createdGo
Edit Print TemplateModify an existing templateGo

Last updated 2026-11-16 19:57