Gookit
Link To — connect label elements to your data
Bind label elements to live store data like product name, price, barcode, metafields, and order fields. Reference of common Link To options for product and address labels in the new and legacy editors.
On this page
What it does
“Link To” connects an element on your label to real data from your store. For example, you can link a text box to the product name, so each label shows the correct name for that product. Without “Link To”, the element shows only static text.
How to use it
- In the template editor, add an element (Text, Barcode, QR Code, or Image).
- Select the element on the canvas.
- In the properties panel, find the Link To dropdown.
- Choose a data field. The element will now show live data when you print.
Available data fields
The data fields you can use depend on two things:
- Label type — Product label or Address label
- Element type — Text, Barcode, QR Code, or Image
The tables pair readable field names with the Link To labels shown in both editors. Uppercase labels such as PRODUCT_NAME and METAFIELD_PRODUCT do not identify the legacy editor. Available fields also vary by store platform. The metafield control below is different between versions.
Product label — Text fields
| Field | Link To label (both editors) | What it shows |
|---|---|---|
| Product Name | PRODUCT_NAME | The product title |
| Product Description | PRODUCT_DESCRIPTION | The product description (use Start With and End At text markers to crop it) |
| Product Weight | PRODUCT_WEIGHT | The product weight |
| Product Tags | PRODUCT_TAGS | Tags on the product (you can filter which tags to show) |
| Variant | VARIANT | The variant option value, like “Red / Large” (you can hide selected options by option name) |
| Custom Text | CUSTOM_TEXT | Text you type yourself — it stays the same on every label |
| Price | PRICE | The product price (you can set currency format and decimal places) |
| Compared At Price | COMPARED_AT_PRICE | The original price before discount (you can choose what to show if there is no compared price) |
| Market Price (presentment price) | MARKET PRICE | The price in a specific market currency (you select which market) |
| Market Compare-at Price | MARKET COMPARE-AT PRICE | The compared price in a specific market currency |
| Unit Price | UNIT_PRICE (legacy: Unit price (per kg, L, etc.)) | The price per unit |
| SKU | SKU | The product SKU code |
| Barcode Text | BARCODE_TEXT | The product barcode number as text |
| Vendor | VENDOR | The product vendor name |
| Product Type | PRODUCT_TYPE | The product type |
| Product Metafield | METAFIELD_PRODUCT | A custom metafield on the product (select a definition in the new editor or enter its key in the legacy editor) |
| Variant Metafield | METAFIELD_VARIANT | A custom metafield on the variant (select a definition in the new editor or enter its key in the legacy editor) |
| Label Quantity | LABEL_QUANTITY | The number of labels being printed for this item |
| Current Date | CURRENT_DATE | Today’s date (you can add a day offset, for example +7 for one week later) |
| Current Date Unix | CURRENT_DATE_UNIX | Today’s date as a Unix timestamp (with optional day offset) |
| Product ID | PRODUCT_ID | The product ID |
| Variant ID | VARIANT_ID | The variant ID |
| Inventory Quantity | INVENTORY_QUANTITY | The current stock level |
Barcode Text (BARCODE_TEXT) displays the stored barcode value in a Text element. To print a scannable barcode, use a Barcode element linked to Barcode, as listed below.
Product label — Barcode fields
| Field | What it shows |
|---|---|
Barcode (BARCODE) | The product barcode |
SKU (SKU) | The SKU as a barcode |
Custom Barcode (CUSTOM_BARCODE) | A barcode with text you type yourself |
Product Metafield (METAFIELD_PRODUCT) | A metafield value as a barcode |
Variant Metafield (METAFIELD_VARIANT) | A variant metafield value as a barcode |
Product ID (PRODUCT_ID) | The product ID as a barcode |
Variant ID (VARIANT_ID) | The variant ID as a barcode |
Supported barcode formats: CODE128, EAN13, UPC-A, UPC-E, CODE39, ISBN, EAN8, GS1-128.
Product label — QR Code fields
| Field | What it shows |
|---|---|
Barcode (BARCODE) | The product barcode as a QR code |
Custom QR Code (CUSTOM_QRCODE) | A QR code with text or URL you type yourself |
SKU (SKU) | The SKU as a QR code |
Online Store Product URL (ONLINE_STORE_PRODUCT_URL) | A link to the product page on your store (you can add a URL suffix) |
Product Metafield (METAFIELD_PRODUCT) | A metafield value as a QR code |
Variant Metafield (METAFIELD_VARIANT) | A variant metafield value as a QR code |
Scan to Cart (SCAN_PRODUCT_TO_CART) Shopify | A special link that adds the product to the cart when scanned |
Product Admin URL (PRODUCT_ADMIN_URL) | A link to the product in your store admin |
Product ID (PRODUCT_ID) | The product ID as a QR code |
Variant ID (VARIANT_ID) | The variant ID as a QR code |
Product label — Image fields
| Field | What it shows |
|---|---|
Custom Image (IMAGE) | An image you upload yourself |
Product Image (PRODUCT_IMAGE) | The main product image from your store |
Variant Image (PRODUCT_VARIANT_IMAGE) | The image for the specific variant |
Product Metafield (METAFIELD_PRODUCT) | A metafield value as an image (the metafield must contain an image URL) |
Variant Metafield (METAFIELD_VARIANT) | A variant metafield value as an image |
Address label — Text fields
| Field | Link To label (both editors) | What it shows |
|---|---|---|
| Order Number | ORDER_NUMBER | The order number |
| Full Address | FULL_ADDRESS | The complete shipping address |
| Address Line 1 | ADDRESS_LINE1 | The first line of the address |
| Address Line 2 | ADDRESS_LINE2 | The second line (apartment, suite, etc.) |
| Country | COUNTRY | The country |
| Zip Code | ZIP_CODE | The postal or zip code |
| City | CITY | The city |
| Province | PROVINCE | The state or province |
| City + Province | CITY, PROVINCE | City and province together |
| Company | COMPANY | The company name |
| Shipping Full Name | SHIPPING_FULL_NAME | The full name on the shipping address |
| Shipping First Name | SHIPPING_FIRST_NAME | The first name |
| Shipping Last Name | SHIPPING_LAST_NAME | The last name |
| Shipping Phone | SHIPPING_PHONE | The phone number on the shipping address |
| Customer Phone | CUSTOMER_PHONE | The customer’s phone number |
| Customer First Name | CUSTOMER_FIRST_NAME | The customer’s first name |
| Customer Last Name | CUSTOMER_LAST_NAME | The customer’s last name |
| Custom Text | CUSTOM_TEXT | Text you type yourself |
Address label — Barcode / QR Code / Image
Address labels have fewer options:
- Barcode: Custom Barcode, Order Number
- QR Code: Custom QR Code
- Image: Custom Image
Using metafields
Metafields let you show custom data that you added to your products or variants in your store.
This works for Text, Barcode, QR Code, and Image elements where metafield sources are available. The chosen product or variant must have a value. For images, the metafield must contain a direct image URL. See Using metafields on labels for a complete example.
Text formatting options
When you link a text element, you can also set:
- Case — Lowercase, UPPERCASE, Capitalized, or Sentence case
- Prefix — Text to add before the data (for example ”$” before price)
- Suffix — Text to add after the data (for example ” kg” after weight)
Good to know
- Changing Link To changes the data source for the selected element. For example, choose PRODUCT_NAME instead of CUSTOM_TEXT to print each product’s title.
- Price fields let you choose the currency format: Regular (1,234.56), None Seperator (1234.56), or Other (1.234,56). You can also set how many decimal places to show (0 to 5).
- The Variant field shows all option values by default. You can hide specific options by option name — type
Color(the option), notRed(the value). See Display product variants with filter options. - Current Date supports a day offset. Set it to 7 to show a date one week from today. This is useful for expiration dates.
- Scan to Cart QR codes create a special URL that adds the product to the customer’s cart when scanned. Shopify
Questions about this article? Email our team.
Send feedback