Zebradesigner For Developers User Guide: Rev-2019-1 P1109190-En

ZebraDesigner for
Developers
User Guide
Rev-2019-1
P1109190-EN
2
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation,
registered in multiple jurisdictions worldwide. All other trademarks are the property of their
respective owners. ©2019 Zebra Technologies Corporation and/or its affiliates. All rights
reserved.
Information in this document is subject to change without notice. The software described in
this document is furnished under a license agreement or nondisclosure agreement. The
software may be used or copied only in accordance with the terms of those agreements.
For further information regarding legal and proprietary statements, please go to:
SOFTWARE: www.zebra.com/linkoslegal
COPYRIGHTS: www.zebra.com/copyright
WARRANTY: www.zebra.com/warranty
END USER LICENSE AGREEMENT: www.zebra.com/eula
Terms of Use
Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its
subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of
parties operating and maintaining the equipment described herein. Such proprietary
information may not be used, reproduced, or disclosed to any other parties for any other
purpose without the express written permission of Zebra Technologies.
Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications

and designs are subject to change without notice.
Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and
manuals are correct; however, errors do occur. Zebra Technologies reserves the right to
correct any such errors and disclaims liability resulting therefrom.
Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or
delivery of the accompanying product (including hardware and software) be liable for any
damages whatsoever (including, without limitation, consequential damages including loss of
business profits, business interruption, or loss of business information) arising out of the use
of, the results of use of, or inability to use such product, even if Zebra Technologies has
3
been advised of the possibility of such damages. Some jurisdictions do not allow the
exclusion or limitation of incidental or consequential damages, so the above limitation or
exclusion may not apply to you.
4
Contents
1 Introducing ZebraDesigner for Developers 7
2 Typographical Conventions 8
2.1 Basic ZebraDesigner for Developers Concepts 8
2.2 Keyboard and Mouse Support 10
2.3 Options (Configuring the Program) 11
3 Workspace Overview 13
3.1 Landing Page 13
3.2 Object and Explorer Panels 14
3.3 Printer and Status Bar 15
3.4 Tabs and Ribbons 16
3.5 Design Surface 43
3.6 Document Properties and Management Dialogs 46
3.7 Context Menus 47
4 Label 50
4.1 New Label Setup Wizard 50
4.2 Label Properties 52
4.3 Label Objects 57
4.4 Working with Objects 75
5 Creating Receipt-Style Labels 78
5.1 New Receipt Setup Wizard 79
5.2 Receipt Style Label Properties 81
5
6 Barcode 85
6.1 Source 85
6.2 Barcode 85
6.3 Check Digit 86
6.4 Human Readable 87
6.5 Bearer Bar 88
6.6 Details 88
6.7 Position 88
6.8 General 89
6.9 Available Barcodes and Their Settings 90
6.10 GS1 DataBar Subtypes 103
6.11 1D Barcode Details 106
6.12 2D Barcode Details 106
6.13 GS1 DataBar Specifics 108
7 Dynamic Data Sources 110
7.1 Variables 110
7.2 Special Character Shortcuts 119
7.3 Insert Characters with <#hex_code> Syntax 121
7.4 Insert Characters with <Alt>+<ASCII_code> 121
7.5 Chip-based Serialization 122
8 Glossary 123
6
1 Introducing ZebraDesigner
for Developers
Welcome to ZebraDesigner for Developers.
Use ZebraDesigner for Developers to design label templates and to store your templates
on your mobile or offline Zebra printers. ZebraDesigner for Developers transforms your
templates into labels when you need to print. ZebraDesigner for Developers also
incorporates variable data from various external business applications into your labels.
ZebraDesigner for Developers lets you send crucial print stream commands and minimizes
the amount of data you need to send.
TIP: Offline printing helps you print labels faster because your label’s variable objects are
already stored on your printers. Offline printing means you can print without using your
label design application. Offline printing is also useful when you want to print without
using your computer due to unacceptable conditions or logistical issues.
7
2 Typographical Conventions
Text that appears in bold refers to menu names and buttons.
Text that appears in italics refers to options, confirming actions like Read only, and locations
like Folder.
Text enclosed in <less-than and greater-than signs> refers to keys from desktop PC
keyboards such as <Enter>.
Variables are enclosed in [brackets].
NOTE: This is the style of a note.
EXAMPLE: This is the style of an example.
This is the style of a best practice.
WARNING: This is the style of a warning.
TIP: This is the style of a tip.
2.1 Basic ZebraDesigner for Developers

Concepts
This section describes the ZebraDesigner for Developers elements that enable you to
efficiently design label templates.
Listed below are the essential ZebraDesigner for Developers concepts. Being familiar with
them provides a perfect starting point for successful labeling projects.
8
l Label
l Object
l Design Surface
If you come across any other unfamiliar items while working with ZebraDesigner for
Developers, refer to the Help tab.
2.1.1 Label
Label works as a template to add label objects and print using any kind of printing media.
Each object adds a different kind of content such as text, line, ellipse, barcode or rectangle
to a label. The content is either fixed (manually entered by the user) or dynamic (defined
using values from connected data sources).
After finishing your label template layout, you can store the template on your printers.
2.1.2 Object
Object is the basic building block for designing labels. To design a label means to select,
add, and position the objects on the design surface.
EXAMPLE: Each object performs a different role. Text object is in most cases used for
single-line textual content that does not need to adapt its font size to the label design.
Barcode object adds a barcode whose type and content can be adapted to the needs of
current document.
Label object types and their purpose are listed here.
2.1.3 Design Surface

Your design surface is a place to create, add, position, and interconnect label objects.
To help you design labels as simply and efficiently as possible, your design surface uses
usability and functional principles from Microsoft Office.
TIP: Use View tab to customize your design surface.
l Learn more about design surface elements here.

l Learn more about design surface editing actions here.
l Learn more about design surface visual aid elements here.
9
2.2 Keyboard and Mouse Support
To efficiently perform and complete the ZebraDesigner for Developers tasks, follow the
guidelines related to the use of keyboard and mouse:
l How to efficiently use keyboard and mouse

l Keyboard shortcuts
2.2.1 Efficient Use of Keyboard and Mouse

Use the following list of tips to make your work with ZebraDesigner for Developers easier
and more efficient.
1. Select object anchoring point. Press <Ctrl> key and click the object placeholders
to quickly define the anchoring point.
2. Label scrolling and zooming. Use mouse wheel to scroll the label. Holding <Ctrl>
when rotating the wheel, adjusts zoom factor. <Shift> scrolls label left or right.
3. Set label or form properties. Double-click the design surface to open the label
properties dialog.
4. Vertical or horizontal object moving. Hold <Shift> while moving an object over
the design surface. The object is moved in straight vertical and horizontal lines.
5. Resize an object with arrow keys. Holding <Shift> while pressing arrow keys
resizes the object.
6. Fine-tune the object position. Hold <Ctrl> while pressing arrow keys.
7. Open contextual menus. Right-click the object or design surface to access the label
or design surface contextual menus.
8. Select multiple objects. Hold <Shift> and click the objects to add them to the
selected objects in a group.
9. Quickly add an object with connected data source. Click the object's shortcut
handle in the object toolbox. A list of available data sources appears. Select a data
source or add a new one, and click the design surface to add an object which already
has a dynamic data source connected to it.
2.2.2 Keyboard Shortcuts

Use keyboard shortcuts to reduce the time needed to accomplish frequent tasks with
ZebraDesigner for Developers. To complete these tasks, use a standard combination of
keys.
10
TIP: Keyboard shortcuts are just a faster and more convenient way of choosing
commands. The command itself is executed in the same way as if it was run from the menu
or toolbar.
Action Press
Select all Ctrl+A
Paste Ctrl+V
Cut Ctrl+X
Move up ↑
Move right →
Move down ↓
Move left ←
Close Alt+F4
Zoom to document Ctrl+0
Copy Ctrl+C
Zoom Out Ctrl+minus sign on numeric keypad
Zoom In/Out Ctrl+mouse scroll up/down
Open Ctrl+O
Zoom In Ctrl+plus sign on numeric keypad
Save Ctrl+S
Open blank label connected to default printer Ctrl+Shift+N
Redo Ctrl+Y
Undo Ctrl+Z
Cancel Esc
Move Focus Tab or Shift+Tab
Store Ctrl+Alt+S
Format painter – copy object properties Ctrl+Shift+C
Format painter – paste object properties Ctrl+Shift+V
2.3 Options (Configuring the Program)

To customize the general program configuration of ZebraDesigner for Developers, open the
Options dialog which is accessible from the File tab.
11
ZebraDesigner for Developers configuration options are grouped on the following tabs:
l Folders: allows you to set the default locations for storing the labels and picture files.
l Language: selects the user interface language. Select the preferred language from
the listed options.
l Designer: enables you to configure opening behavior of ZebraDesigner.
12
3 Workspace Overview
Your ZebraDesigner for Developers workspace provides a flexible and easy-to-use

environment for simple label designing.
Your ZebraDesigner for Developers workspace follows widely used application interface
guidelines and is equipped with tools and interface elements familiar to most users.
ZebraDesigner for Developers workspace includes the following:
l Landing page
l Object and Explorer Panels
l Printer and Status bar
l Tabs and Ribbons
l Design Surface
3.1 Landing Page

Your landing page in ZebraDesigner for Developers is an introduction which opens after the
application loads. The page includes the following:
l New document area: create new or open existing ZebraDesigner for Developers
documents.
l Create a New Label: create new label documents.
l Create a New Receipt: create new receipt style labels.
l Recent Files: lists recently used ZebraDesigner for Developers files.
l Learning resources: access useful resources to help you create labels, and learn
more about ZebraDesigner.
l Printer Drivers: access Zebra printer drivers. Drivers let you optimize your labels to
print on specific printer models.
13
3.2 Object and Explorer Panels
Object and explorer panels are located at the left-most area of the ZebraDesigner for
Developers window. They provide access to objects.
l Object Toolbox: Contains available objects. These objects are ready to be used on a
label. Click the selected object and drag it to the design surface.
l Dynamic Data Explorer: The tool for managing your data sources.
3.2.1 Dynamic Data Explorer

The Dynamic Data Explorer performs two roles. It serves as a tool for managing your
variables, and gives an overview of the data sources that are currently in use.
NOTE: Right-clicking your variables allows you to cut, copy, paste, delete, edit, and
rename them.
14
l Add new variable: adds an additional variable to the label data sources. There are
four default variable types available. Their values are defined via dialogs described in
dedicated sections
l Variable: a type of variable that obtains value when a label is printed.
l Current date: displays current date in the requested format.
l Current time: displays current time in the requested format.
l Counter: displays a counter value.
l RFID Tag: If you are working with an RFID compatible printer, you can directly add the
content encoded in the RFID tag to your label as Text, Text Box or Barcode objects.
3.3 Printer and Status Bar

Printer and Status bar stretches over the bottom part of the ZebraDesigner for
Developers window. The bar performs these roles:
l Printer Selection for the current print job. Select your preferred printer from the
drop-down list of installed printers.
TIP: When changing a printer, label and paper size adapt automatically to the dimensions
defined by the printer driver.
NOTE: Working with ZebraDesigner for Developers is tied to your installed Zebra printer
drivers. As a result, only supported printer drivers are listed on the printer selection list.
l Printer Properties: Gives you direct access to the properties dialog of the selected
printer driver.
l Design surface zooming.
l RFID Status and Tag Access: Indicates if writing the data to the RFID tags is enabled
or not. Click the button to open the RFID tag dialog. This is where you can enable or
disable writing to RFID tags.
15
3.4 Tabs and Ribbons
ZebraDesigner for Developers uses a standard Windows-based interface.
The ZebraDesigner for Developers's top section interface segments are described below.
3.4.1 Tabs
Tabs represent subsets of ZebraDesigner for Developers features. The tabs contain
interrelated commands that are available to the user in an organized way – grouped, and
labeled:
l File (background): opens the store form and document management panel.
l Home: offers commonly used commands such as copy/paste, print, and style
commands.
l Data: offers data source related commands.
l View: gives you control over layout tools, zooming options and element markers
visibility.
l Contextual tabs: appear after clicking an object. They allow you to define object-
specific settings. The type of contextual tabs adapts to the selected object.
l Help: besides offering the access to F1 help, this tab leads you to multiple helpful
resources that make your work with ZebraDesigner for Developers easier and more
efficient.
3.4.2 Ribbon
Ribbon is a rectangular area that spreads across the top of an application window. Related
commands are divided into ribbon groups. The ribbon changes along with the selected tabs
and adapts to the currently used tools using the contextual tabs.
3.4.3 File Tab

File tab serves as document management panel. The following options are available:
l Start: takes you to the ZebraDesigner for Developers landing page.

l New: creates a new stand-alone label.
l Open: allows opening existing label.
l Save: saves the active label.
l Save As: allows saving the active label file by defining its name and location.
l Store: stores the current label as a template on the printer to be used in store/recall
mode.
l Close: closes the current ZebraDesigner for Developers document.
16
l Options: opens the dialog for configuring the program defaults.
l About: provides software version information.
l Exit: closes the application.
3.4.3.1 Start
Start panel takes you to ZebraDesigner for Developers landing page. Use it to create or
open documents, access recently opened files, preview files and learn more about
ZebraDesigner for Developers.
3.4.3.2 New
New Label creates a new stand-alone label. New Label Setup Wizard opens after clicking
this button.
New receipt creates a new receipt style label. Start designing variable length receipts with
predefined header, body, and footer objects. Details are available in section "Creating
Receipt-Style Labels" on page 78
New from Sample Templates creates a document based on a selection of

industry-standard templates.
TIP: There are two ways of opening new labels. You can open each additional document
in a separate instance (window) of ZebraDesigner for Developers. An alternative way is to
open documents within the already opened instance. To select the way that suits you
better, go to File > Options > Designer.
3.4.3.3 Open
Open dialog allows opening existing label files.
Browse allows selecting the label on local or connected network drives.
Recent Files field lists the latest files that have been edited. Click any of them to open the
file.
3.4.3.4 Save
Save panel saves the active label using the same file name that was used to open it.
NOTE: If a file has been opened for the first time, Save directs you to the Save as on the
File tab.
3.4.3.5 Save as
Save as allows saving the active label file by defining its name and location.
17
Recent folders field lists the folders that were recently used to save the label files.
3.4.3.6 Storing Label Templates

Store label templates you create directly into your printer memory for faster printing or
printing offline. Recall your stored templates to print labels using integrated external
business applications without installing additional software. The store and recall features of
ZebraDesigner for Developers help you create, store, test, and integrate labels you recall
and print with external business applications.
l Store: save your pre-made templates in your printer memory.

l Recall: print labels from your printer memory using your pre-made templates
populated with variable data.
Store and recall your label templates using the following sections:
Operation
l Store template to printer: store your pre-made templates in your printer memory.
l Store template to printer then recall: store your pre-made templates in your printer
memory and immediately recall labels you manually populate with variable data. Use
this feature to test your printing process and diagnose problems. Normally, you recall
labels populated with variable data from external business applications.
l Generate print file with variables: generate .prn files of commands you send to your
printers in ZPL format. ZebraDesigner for Developers saves your print files on your
local disk, not in your printer memory. Use print files to analyze your print streams,
replace variable names with values, and integrate your stored label templates with
external business applications.
Recall stream format
Choose which format your printer uses to populate variables when you recall your labels.
l XML: recall your labels using variables populated in XML format.

l ZPL: recall your labels using variables populated in ZPL format.
Store fonts
Zebra printers use Zebra internal fonts by default. To use other fonts (e.g., TrueType and
OpenType fonts) on your labels, use your printer driver settings to store them on your
printer in Zebra format. Select Yes to associate these other fonts with your label templates
in your printer memory and use them on all your printers.
18
NOTE: When you connect text objects to variables, use Zebra printer fonts. Your printer
displays TrueType and OpenType fonts as graphics, which causes printing errors with
variables.
Destination
Choose where to store your label templates.
l Network printers and click Printers: view, add to, search, and choose from your list
of network printers.
l Local disk and click Browse: save your templates to your local disk in .prn format.
l Printer selected in label: store your templates using your currently active printer
driver.
Template name on printer
Your printer holds multiple templates. Give your templates unique names so you can find and
recall them later.
NOTE: ZebraDesigner for Developers limits your template names to 16 characters.
Printer memory location
Zebra printers have different memory types. Choose your printer memory location
according to your printer specifications (For example: DRAM, Internal Flash, etc.).
Now you understand how to store your label templates on your printer and recall, populate,
and print labels offline or use integrated external business applications.
3.4.3.7 Options (Configuring the Program)

To customize the general program configuration of ZebraDesigner for Developers, open the
Options dialog which is accessible from the File tab.
ZebraDesigner for Developers configuration options are grouped on the following tabs:
l Folders: allows you to set the default locations for storing the labels and picture files.
l Language: selects the user interface language. Select the preferred language from
the listed options.
l Designer: enables you to configure opening behavior of ZebraDesigner.
19
3.4.3.7.1 Folders
Folders tab defines the default location for opening and storing the documents and files
which are edited and used in ZebraDesigner for Developers.
NOTE: Make sure read/write rights are granted to the account under which the
ZebraDesigner for Developers is running.
l Labels: location for opening and saving the label files.

l Pictures: location for opening the picture files.
Folders set in this tab serve as the default location when searching for a specific file in
ZebraDesigner for Developers.
3.4.3.7.2 Language
Language tab allows selecting the ZebraDesigner for Developers interface language. Select
the appropriate language and click OK.
NOTE: Restart is necessary to make the user interface appear in the selected language.
Make sure you save your work before closing the program.
3.4.3.7.3 Designer
Designer tab enables you to configure opening behavior of ZebraDesigner for Developers.
Opening Mode group defines how your ZebraDesigner for Developers opens new
documents.
l Display each document in its own window: If enabled, additionally opened

documents appear in separate windows of ZebraDesigner for Developers. This
applies to both – newly created and existing documents.
If you decide to disable this option, additionally opened documents will appear within
the currently active instance of ZebraDesigner for Developers.
Variables group allows you to set the default variable properties while designing your label
templates.
l Default name prefix for new variables: Defines the default name prefix for the
variables that you add while designing label templates. This is the name prefix that
automatically appears in the variable creation dialog. ZebraDesigner for Developers
20
adds serial numbers to the variables with the same name prefix.
EXAMPLE: By default, the variables in ZebraDesigner for Developers have XML

name prefix. If you create three variables for your label template, the names of your
variables are XML, XML1, and XML2.
3.4.3.8 About
The About dialog page contains software information for your copy of ZebraDesigner for
Developers.
3.4.4 Home Tab

Home Tab provides access to frequently used commands and settings in the following
ribbon groups:
l Clipboard: group temporarily stores the selected elements, objects or groups of

objects.
l Font: group lets you define the font properties.
l Action: group allows you to store label templates and run test prints.
l Management: group provides direct access to Document properties.
l The Align group options define relative horizontal and vertical positioning for the
object content.
l Objects: group allows you to align, group or arrange label objects.
3.4.4.1 Clipboard
Clipboard group temporarily stores the selected elements, objects or groups of objects.
Use the selected and stored objects to transfer them from one label to another.
TIP: Copying and pasting of textual (plain text) and graphical (bitmaps) content between
multiple applications is supported.
l Paste: pastes the clipboard contents on the design surface. Multiple reuse of a single
clipboard item is allowed.
l Cut: removes the selected element(s) from the design surface and adds it to the
clipboard to be pasted elsewhere. Note that the first element is selected by clicking
it. When selecting additional elements, press and hold <Shift> key while clicking
these elements.
l Copy: copies the selected content to the clipboard. Multiple objects can be copied at
once – select them and click Copy.
l Format painter: copies the formatting properties from one object to another. This is
how you multiply the style of your reference object.
21
EXAMPLE: Use the format painter to copy font, font size, font color, alignment and
spacing from your reference Text object to all other Text objects using a single
action.
To copy the object style properties:
1. Click your reference object. This is the object you want to copy the properties
from.
2. Click the format painter.
3. Click the target object. This object now has the same properties as your
reference object.
When using the format painter for different objects, you are copying and pasting the
object's properties from the Style tab. If there are matching Style properties
between the objects, ZebraDesigner for Developers transfers these properties to
the target object.
EXAMPLE: When multiplying the properties from a Rectangle object to Ellipse

objects, all Style tab properties apply, except for the corner radius. This property is
only applicable to the Ellipse object.
3.4.4.2 Font
Font group defines font properties:
l Show/hide printer fonts: button allows you to exclusively display internal printer
fonts on the list of available fonts. Graphical fonts are hidden in this case. After
pressing this button again, all available fonts are visible on the list once more.
l Font: defines the font family to be used in a selected object.
l Font Size: defines the text size in an object. Select the desired point size from the
dropdown selector or enter it manually.
l Font Style: defines the object text stylistic characteristics of text, such as bold or
italic.
l Alignment: defines horizontal text positioning in an object: Left, Center or Right.
l Justify: makes a paragraph aligned along the left and right object margins.
TIP: When changing a font during the design process, ZebraDesigner for Developers
remembers the last used font type and size.
3.4.4.3 Action
Action group allows you to store label templates and run test prints.
22
Use the Store button to store your label templates on printer. During the storing procedure,
ZebraDesigner for Developers converts the label template to a print stream that your Zebra
printer can interpret. The result are stored labels with empty variable values, which are
assigned during the recall.
Use the Test Print button to verify the label printout on your Zebra printer. By pressing this
button, you print the labels populated with provisional values on your Zebra printer.
3.4.4.4 Management
Management ribbon group provides direct access to:
l Document Properties opens current label properties.
3.4.4.5 Align
The Align group options define relative horizontal and vertical positioning for the object
content:
l Align Objects Left: aligns objects with the left border of the first selected object or
with the leftmost object.
l Align Objects Center: aligns objects with the horizontal center of the first selected
object or with horizontal center of the largest object.
l Align Objects Right: aligns objects with the right border of the first selected object
or with the rightmost object.
l Distribute Horizontally: distributes objects using equal horizontal spacing.
l Align Objects Top: aligns objects with the upper border of the first selected object or
with the highest object.
l Align Objects Middle: aligns objects with the vertical center of the first selected
object or with vertical center of the largest object.
l Align Objects Bottom: aligns objects with the bottom border of the first selected
object or with the lowest object.
l Distribute Vertically: distributes objects using equal vertical spacing.
3.4.4.6 Object grouping and arranging

The Objects group helps you work with mutiple objects.
23
l Group objects unites the selected objects and makes them behave as a single
object.
l Ungroup objects: separates the grouped objects.
Arrange positions the objects so that they appear either in front of or behind each other.
l Send Backward: sends the element back one level.

l Send to Back: sends the element behind all other elements on the label.
l Bring Forward: brings the element forward one level.
l Send to Front: sends the element in front of all other elements on the label.
Delete allows you to remove the selected individual or group objects from your label
template.
3.4.5 Data Tab

Data tab displays the ZebraDesigner for Developers ribbon with groups that enable you to
instantly connect an object with commonly used data sources:
l RFID ribbon group gives direct acces to RFID Tag dialog.
3.4.6 View Tab

View Tab gives you control over document zooming, marker visibility, visual aids and design
surface rotation. It makes the following ribbon groups available:
l Zoom: defines design surface zoom level and ZebraDesigner for Developers window
zoom behavior.
l Object Markers Visibility: defines visibility settings for object properties.
l Alignment and Gridlines: sets object positioning behavior and defines properties for
design surface gridlines.
l Rotation: rotates the design surface clockwise for 90 degrees per click.
3.4.6.1 Zoom
Zoom group defines the design surface zoom level.
l Zoom to Document: displays the entire label in the ZebraDesigner for Developers
window.
l Zoom to Objects: displays all objects in the ZebraDesigner for Developers window.
l Zoom In: magnifies the design surface by a percentage of the currently defined zoom
level.
l Zoom Out: decreases the design surface by a percentage of the currently defined
zoom level.
24
l Zoom percentage drop-down menu: allows you to type in or select the exact
zooming percentage for your current document.
3.4.6.2 Object Markers Visibility

Objects markers visibility group toggles the visibility for the following object properties:
l Object Name: displays the name of an object.

l Printer Element: indicates that the object will be printed using a printer built-in
function. This options serves as an alternative to sending the object to printer as a
graphic.
l Data Source: indicates that the object is connected to a dynamic data source.
3.4.6.3 Alignment and Gridline Guides

Alignment and Gridlines group sets object positioning behavior and defines properties for
design surface gridlines.
l Display gridline guides: makes the design surface grid dots visible.
l Grid Size X: defines horizontal distance between the grid dots.
l Grid Size Y: defines vertical distance between the grid dots.
l Grid Offset X: defines the horizontal offset of the grid from the design surface
center.
l Grid Offset Y: defines the vertical offset of the grid from the design surface center.
l Align to Objects: makes an object align with other objects on the design surface.
When an object is aligned, a line which marks the object alignment appears.
l Align to Gridlines: aligns the selected objects with gridlines.
l Do Not Align: makes the object position independent of gridlines and position of
other object(s).
3.4.6.4 Rotation
Rotate view button rotates the design surface clockwise. Horizontal and vertical rulers
adapt to the current position of the design surface.
TIP: Rotation type is defined by the printer driver. Certain drivers support complete 360
degrees rotation (90 degrees per click), while others allow 90 degrees rotation clockwise
(portrait/landscape).
3.4.7 Contextual Tabs

Contextual tab is a hidden tab that becomes visible when a specific label object is selected
on the design surface. Contextual tabs appear on the right side of the standard
25
ZebraDesigner for Developers tab. The selection of displayed tabs depends on the object
that you are currently editing.
l Label-specific contextual tabs are described here.
3.4.7.1 Label-specific Contextual Tabs

When editing various label objects, the following contextual tabs appear depending on the
selected object:
l Design tab
l Barcode tab
l Shape tab
l Picture tab
l Text tab
3.4.7.1.1 Design Contextual Tab
Design tab serves as a contextual tab that defines the layout and positioning of the
selected label object.
The following groups of settings are available on the Design tab:
l General: defines object's visibility and printability on a label.

l Positioning: defines the object's position on the design surface.
l Arrange: positions the object relative to neighboring objects on a label.
General
General group defines the object's visibility and printability on a label.
l Not printable: when enabled, this option prevents the object from being printed on
the label. The object remains visible on the label preview.
l Visible: when disabled, the object neither appears on the print preview nor on the
printed label. The object is treated as if it does not exist.
l Printing Optimization: allows activating the use of printer elements (available with
rectangle, barcode, line, ellipse and inverse objects).
l Name: allows you to enter object name and its description.
26
Positioning
Positioning group sets the object location and size on a label.
Position button opens:
l X and Y: coordinates set the exact position on the design surface.

l Width and Height: object dimensions.
l Keep Aspect Ratio: makes sure both object dimensions change proportionally while
resizing.
l Rotation angle: rotates the object clockwise.
Anchoring Point button defines the spot where an object is pinned to the design surface.
Variable size objects increase or decrease their size in the direction that is opposite to the
chosen anchoring point.
Keep Aspect Ratio: makes sure the object is resized proportionally.
Lock prevents the selected object from being moved during the design process.
Arrange
Group objects: adds selected objects to a group.
l Group objects: unites the selected objects and makes them behave as a single
object.
l Ungroup objects separates previously grouped objects.
Arrange: defines how objects are positioned in a group.
l Bring forward: moves the selected object up one layer.

l Bring to front: moves the selected object to the top of the object stack.
l Send backward: moves the selected object down one layer.
l Send to back: moves the selected object to the bottom of the object stack.
Align group allows setting the alignment and spacing for objects on the design surface. All
objects can be aligned according to the neighboring object or according to the document
border.
Horizontal alignment options are:
l Left: aligns the selected objects with the left edge of the leftmost object or with the
left edge of the first selected object. If a single object is selected, it is placed on the
label's left border.
27
l Center Horizontally: aligns the selected objects with the horizontal center of the
largest selected object or with the horizontal center of the first selected object. If a
single object is selected, it is placed in the horizontal center of a label.
l Right: aligns the selected objects with the right edge of the rightmost object or with
the right edge of the first selected object. If a single object is selected, it is placed on
the label's right border.
l Distribute Horizontally: equalizes horizontal spacing between the objects.
Vertical alignment options are:
l Top: aligns the selected objects with the top edge of the topmost object or with the
top edge of the first selected object. If a single object is selected, it is placed on the
label's top border.
l Center Vertically: aligns the selected objects with the vertical center of the largest
selected object or with the vertical center of the first selected object. If a single
object is selected, it is placed in the vertical center of a label.
l Bottom: aligns the selected objects with the bottom edge of the lowest object or
with the bottom edge of the first selected object. If a single object is selected, it is
placed on the label's bottom border.
l Distribute Vertically: equalizes vertical spacing between the objects.
3.4.7.1.2 Barcode Contextual Tab
Barcode tab serves as a contextual tab that defines the type, layout and positioning of
barcode object.
The following groups of settings are available on the Barcode tab:
l Barcode: defines basic barcode symbol type and its dimensions.

l Settings: defines barcode details.
Barcode Tab
Barcode group allows you to choose the barcode type and to set the dimensions of your
barcode symbol.
NOTE: Settings in Barcode group depend on the selected barcode type.
l Barcode Type: defines the type of the barcode symbol to be used on a label.
By default, Code128 barcode type is selected. For more details about the available barcode
types, see section Barcode Types and Available Settings.
28
l DataBar Type: if one of the DataBar barcode types is selected, DataBar Type
defines its specific subtype to be used on the label.
l X dimension: width of the barcode's narrow bar in the selected Unit of
measurement.
l Height: vertical dimension of your barcode in the selected Unit of measurement.
l Ratio defines the ratio between the barcode's narrow and wide bar widths.
Each barcode type's range of permitted ratios is limited by the standard.

ZebraDesigner for Developers only allows you to use valid ratios. By default, the ratio
is set to 3. This means that the wide bar is 3 times the width of a narrow bar.
NOTE: The available ratios depend on the selected X dimension. If you are
changing the X dimension, this also affects the selection of available ratios.
l Row height defines the height of a single data row in 2D barcodes. Row height is
specified as a multiple over the X dimension.
Settings
Settings group allows you to configure barcode details.
Human Readable button defines the human readable content's layout.
l No human readable: makes the barcode appear without the human readable text.
l Above barcode: locates human readable text above the barcode.
l Below barcode: locates human readable text below the barcode.
Style group allows you to set custom properties for human readable text.
l Custom Font: enables font and font size selection. Internal printer fonts cannot be
used as custom human readable font.
l Auto font scaling: If enabled (default setting), human readable text grows or shrinks
proportionally along with the changing size of the barcode. To set a custom size for
human readable text, disable this option and select the appropriate font size.
l Bold: makes human readable text appear bold.
l Italic: makes human readable text appear italic.
Mask group sets the format of the input data before it is displayed on a label.
l Content mask sets the format of the input data before it is displayed on a label.
l Mask character is a character used in the mask that is replaced with actual data on
the printed label.
29
EXAMP LE
A use r n e e ds t o format a ph on e n umbe r t o be more re adable on t h e labe l.

D at a in put is n ot format t e d sin ce it is re ad from a dat abase .
If t h e in put value re ad from a dat abase is:
+38642805090
an d t h e con t e n t mask is:
(****) **** - ****
t h e re sult in g out put is:
(+386) 4280 - 5090
If t h e dat a con t ain s t h e ast e risk "*" ch aract e r, ch an ge t h e Mask c har ac ter .
Th e ch aract e r sh ould h ave a un ique value t h at doe s n ot appe ar an ywh e re
in t h e dat a.
Barcode Details differ according to the barcode standards. Define the options that are
given with regard to the currently selected barcode type. Details for 1D and 2D barcodes
are described in dedicated sections:
l 1D barcode details
Check digit is derived from the preceding barcode digits and is placed as the final digit of a
barcode.
Color: sets the barcode's line and human readable content color on the printed label.
Arrange
object.

30
border.
label's top border.
3.4.7.1.3 Shape Contextual Tab
Shape tab serves as a contextual tab that defines the appearance of ellipse, rectangle and
line objects.
The following groups of settings are available on the Shape tab:
l Outline: defines how the line of the selected shape should appear.

l Fill: group defines the shape's fill style and color.
31
Outline
Outline group defines how the line of the selected shape should appear.
Outline Style button options are:
l None: makes the object line invisible.

l Solid: makes the object line solid.
l Dot: makes the object line dotted.
l Dash: makes the object line dashed.
l Clear: makes parts of other objects underneath the line invisible.
Outline Color defines the color of the shape's line.
Thickness defines the object line's width.
Corner radius: makes the rectangle corners round. Higher values make the curve broader.
Fill
Fill group defines the shape's fill style and color.
Fill Style options are:
l None: makes the object completely transparent.

l Clear: makes other objects beneath the active one invisible.
l Solid: fills the object with solid color.
l 25% of color: sets fill color opacity to 25 %.
l 50% of color: sets fill color opacity to 50 %
l 75% of color: sets fill color opacity to 75 %.
Background Color defines the color of the shape's fill.
Arrange
object.

32
border.
label's top border.
3.4.7.1.4 Picture Contextual Tab
Picture tab serves as a contextual tab that defines picture resizing options and object
arranging.
The following groups of settings are available on the Picture tab:
l Resize: resizes the object relative to neighboring objects on a label.

Resize
Resize group defines if the picture adapts to the label size at print time or not.
Picture Fit button opens the picture sizing options.
33
l Resize options: define how the source file dimensions adapt to the size of object at
print time.
l Keep original picture size: disables resizing. The source file is displayed using
the object with its original dimensions.
l Resize proportionally: makes the source file resize proportionally. The aspect
ratio of source file dimensions is preserved.
l Resize to the designed size: resizes the picture horizontally and vertically to
make it fit into the bounding box. Using this option will most likely make the
picture distorted.
l Original size: displays the picture's Width and Height before resizing.
l Revert to original picture size: removes resizing actions.
Keep Aspect Ratio makes sure both object dimensions change proportionally while
resizing.
Arrange
object.

border.
34
label's top border.
3.4.7.1.5 Text Contextual Tab
Text tab serves as a contextual tab that defines formatting of Text object.
The following groups of settings are available on the Text tab:
l Format: lets you define the text format.

l Text Settings: lets you define the layout of any textual content that is added to label
object.
Format
Format group lets you define the text format.
l Show/hide printer fonts: button turns visibility of printer fonts on the font list on/off.
l Font: allows specifying the typeface and its size. Fonts fall into two groups, OpenType
fonts and Printer fonts.
NOTE: If the currently selected printer is a thermal printer, additional fonts will be
visible on the list of available fonts. These are the Printer fonts identified by the
printer icon in front of their names.
l The font may appear Bold, Italic, Underlined or as a Strikethrough text.

l Alignment buttons allow you to align the text to the left, center, right, or evenly.
35
l Font color: specifies font and underscore color.
l Increase/decrease font buttons allow you to gradually change the font size.
l Scaling: factor that defines how much the font is stretched from its original
proportions.
NOTE: If the stretch factor is set to 100 %, the font has a normal look. If factor is
200 %, it means that font is twice as wide as normal. If it is 50 %, the font is half as
wide.
Text Settings
Text Setting group allows defining the layout of any textual content that is added to the
object.
Character and Paragraph button opens line and character spacing options:
l Line spacing: distance between each line in a paragraph.

l Character spacing: distance between individual characters.
Effects button displays the available text effects:
l Inverse: inverts the colors of text and background.
Arrange
object.

border.
36
label's top border.
3.4.8 Help Tab

Help tab provides direct access to various resources that help you design and use labels
quickly and efficiently.
Help ribbon group includes buttons with links to the following resources.
l Help: ZebraDesigner for Developers online help.

l Knowledge Base: online library of articles that describe many technical solutions,
tips, and solved issues for labels.
l Sample Files: access to the collection of sample label files. Use them to become
familiar with ZebraDesigner for Developers and to explore software capabilities.
l Technical Support: connects you with Zebra technical support department.
Product ribbon group includes links to:
l Software About page

l Zebra Home Page: www.zebra.com
37
3.4.9 RFID Tag
The RFID Tag dialog allows you to select the appropriate RFID tag type, to define its
content, and to configure which type of data is going to be encoded on the tag.
NOTE: RFID functionality is available with installed Zebra printer driver.
RFID Tag dialog allows you to configure how the tag content is encoded in a tag:
l Select the RFID tag type.

l Configure various tag settings related to its structure and programming.
l Set the RFID security parameters.
l Insert and configure data fields.
3.4.9.1 Tag
The Tag panel of the RFID Tag dialog allows you to select which tag type is going to carry
the encoded data and how the data should be written to the tag.
Tag group includes the tag type selection.
l Tag type dropdown list offers the selection of available RFID tag types. The selection
of tag types is automatically defined by the printer driver.
Select the printer (and the corresponding driver) for the label with RFID tag in the status
bar.
Usage group defines the RFID Tag data sources and how the data is written to the tag.
l RFID write enabled: Enables or disables data writing to the RFID tag.
TIP: Disabled writing might be useful during the label designing process or during
specific workflow phases.
The encodable RFID data fields are added to the Dynamic Data explorer under RFID Tag.
DATA FIELD P OS S IB ILITIES
- EP C : D at a fie ld wit h Ele ct ron ic Product Code
- User Data: D at a fie ld wit h t h e con t e n t t o be e n code d on t h e RF ID t ag
- TID: D at a fie ld wit h un ique ID of t h e RF ID t ag
38
TIP: Drag the appropriate data field and place it on the label in form of a Text, Text Box, or
Barcode object (defined by the driver).
3.4.9.2 Content
The Content panel of the RFID Tag dialog allows you to define the content of an RFID tag.
To encode the data in an RFID tag, complete the following steps.
Step 1: Select Data Fields
Data Fields group allows you to select the data fields. These fields are going to
contain the encoded data of the RFID tag.
NOTE: The selection of available Data Fields with corresponding settings

depends on the selected Tag type.
DATA FIELD EXAMP LES
- TID: un ique ID of t h e RF ID t ag
- EP C : syn t ax for un ique ide n t ifie rs assign e d t o obje ct s, un it

loads, locat ion s, or ot h e r e n t it ie s t h at are in clude d in busin e ss
ope rat ion s
- User Data: payload dat a t o be writ t e n in t h e RF ID t ag
- RFID Tag Mem or y : t h e on ly dat a fie ld available for n on -G e n 2

RF ID t ags
Step 2: Select Data Type
Data type defines the method for entering the Data field content. The
availability of data types depends on the selected Data field.
l Memory block: the table allows you to enter the data into individual
RFID tag memory blocks. Each table row represents a single block of the
selected Tag type.
Memory block structure and properties of individual blocks depend on the

selected Tag type.
Data type can be defined for each block individually:
39
l Electronic Product Code (EPC): added fields allow you to enter the
RFID data according to the EPC standard.
l ASCII string: RFID data to be entered as a string of ASCII characters.
l HEX encoded string: RFID data to be entered as a string of hexadecimal
pairs.
Encoding type allow you to select the data encoding format that corresponds
to your current Data type.
NOTE: Details about the SGTIN encoding type and the chip-based

serialization are available in section "Chip-based Serialization" on page 122.
Step 3: Insert Value
Insert the value to be encoded in the RFID tag according to the selected Data
type.
3.4.9.3 Security
Security tab of the RFID Tag dialog allows you to configure the RFID tag security settings.
These settings allow or deny access to RFID data writing or editing.
Security settings depend on the selected printer. There are three major configuration
types.
3.4.9.3.1 Multiple Memory Fields
Access Protection group sets a password that must be entered before editing or writing
the RFID data.
Data type defines the method for entering the Password.
l ASCII string: Password should be entered as a string of ASCII characters.

l HEX encoded string: Password should be entered as a string of hexadecimal pairs.
l Numeric: Password should be entered as a string of digits.
Kill code defines the code that disables the RFID tag permanently and irreversibly.
TIP: Once the kill code is activated, the data can neither be retrieved from nor written to
the tag.
Data type defines the method for entering the Kill code characters.
40
l ASCII string: Kill code should be entered as a string of ASCII characters.
l HEX encoded string: Kill code should be entered as a string of hexadecimal pairs.
l Numeric: Kill code should be entered as a string of digits.
3.4.9.3.2 Multiple Memory Fields With Block Locking
Additional settings from Multiple Memory Fields allow the user to set the locking for
individual blocks within RFID tag memory fields.
Locking group includes an overview of the memory fields that are included in the RFID tag.
Each memory field can be locked individually.
Select locking settings allows you to define how the blocks are locked.
l Preserve original setting: original locking setting cannot be retrieved, but the
default option assumes that the tag setting should remain unchanged.
l Lock: block is locked and further changes are prevented.
l Unlock: block is unlocked and editable.
l Relock: RFID tag is unlocked for the changes to be applied. When done, the tag is
relocked immediately.
l Permanent lock, unlock or relock: makes the above described settings permanent.
These settings cannot be undone.
Blocks for locking: defines the individual blocks or range(s) of blocks to be locked.
TIP: Individually locked blocks are defined with an index and separated by a comma (with
or without inserting the space between). Ranges of blocks are defined with a dash.
41
3.4.9.4 Settings
Settings tab of the RFID Tag dialog allows you to configure various tag settings related to
its structure and programming.
All available settings are listed in a table under the Settings group:
NOTE: The selection of available settings depends on the current Tag type.
3.4.9.5 RFID Read and Print

This section describes how to define which data fields from the RFID tag should be read and
printed on the label using the internal printer elements.
To configure the data field properties and to make the RFID encoded data on the label, drag
it to design surface. After adding it to design surface, the data field appears as a normal Text
label object with the following additional properties.
Data format defines the format in which the RFID data field content is written in the label
object and printed.
NOTE: Available data formats and number of permitted characters are defined by the
printer driver and selected tag type.
l HEX encoded string: data field content is a string of hexadecimal pairs.

l ASCII string: data field content is a string of ASCII characters.
l Numeric: data field content is a string of numbers.
42
NOTE: You must select a printer's native font (those stored internally on the printer) to
print. All other fonts will result in an error.
Preview presents the data field content as it would appear using the selected Data format.
Preview field does not include the actual encoded data. Enter the characters manually. By
default, the object contains as many question marks, as given by the length of the RFID data
field.
TIP: The role of Preview field is to fill the object with dummy content during the label
design process and to give an impression of its layout on the printed label. The object on
the actual printed label displays the content which was read from the RFID tag.
Data Extraction group defines which part(s) of data field content should be read from the
RFID tag and printed on the label.
TIP: By default, the entire range of encoded data is read from the RFID tag.
l Select bytes: specifies which bytes of the encoded RFID tag data should appear in
the label object.
l Starting byte: the number of the byte in an encoded string which starts the
selection.
l Length in bytes: number of selected bytes which should be extracted from the
encoded data.
l Select blocks: specifies which blocks of the encoded RFID tag data should appear in
the label object.
l Starting block: the number of the block in an encoded string which starts the
selection.
l Number of blocks: number of selected blocks which should be extracted from
the encoded data.
3.5 Design Surface

Your design surface is a place to create, add, position, and interconnect label objects.
To help you design labels as simply and efficiently as possible, your design surface uses
usability and functional principles from Microsoft Office.
TIP: Use View tab to customize your design surface.
43
l Learn more about design surface elements here.
l Learn more about design surface editing actions here.
l Learn more about design surface visual aid elements here.
3.5.1 Design Surface Elements

Design surface consists of the following elements:
l Ruler: Design surface is equipped with horizontal and vertical ruler. Use it to line up
the objects or to properly position the label and its content. Change the unit
measurements displayed on the ruler in Label properties.
l Paper: Yellow area of the design surface displays the current size of paper. The
information about supported paper format is acquired from the printer driver, but you
also have the option to define custom format. Manual paper size has to be defined
when printing on regular office sheets of paper. See Paper section for more details.
l Label: White area represents the area for label designing. Red line displays limit of the
currently printable area.
l Object Properties Window: Defines the selected label object's properties.
Double-click an object to open the dialog.
3.5.2 Design Surface Editing Actions

Below listed are the most relevant common actions for editing the objects on design
surface:
44
l Object arranging: allows the objects to be placed in front of or behind other objects
in a group. Arranging options are described here.
l Objects aligning: allows the objects to be aligned among each other. Aligning
options are described here.
l Zooming: enables the entire design surface to be zoomed in or out. Zooming options
are described here.
l Scrolling: enables sliding the design surface up and down.
l Selecting: enables the objects on design surface to be selected for editing
individually or in a group. Group selection allows any actions to be applied to multiple
objects simultaneously.
l Rotating: enables object rotation.
3.5.3 Visual Aid Elements

Listed below are the visual aid elements that enable you to work with ZebraDesigner for
Developers.
l Gridlines serve as a visual aid during the design process. They can be either visible
or hidden. Their density is customizable. Gridline options are available in the
Alignment and Gridlines ribbon group.
l Snaplines are non-visible alignment lines that help the user align the objects during
the design process. Snap options are available in ZebraDesigner for Developers's
Align ribbon group.
l Ruler shows the available design area for label (white colored field) and file page (gray
colored field).
l Resize handles appear on the selected (active) objects. They enable you to resize
the object dimensions. X and Y dimensions can be resized simultaneously or
separately.
l Margins are the amount of fixed space between the edge of an object and the edge
of a label.
3.5.4 Object Properties Window

When designing a label object, double-click an object to set its properties.
Double-click opens the object properties window. Available object properties window
options adapt to each selected object and its properties.
l Available label objects and their properties are listed and described in detail here.
45
3.6 Document Properties and Management
Dialogs
ZebraDesigner for Developers offers multiple dialogs that help you configure and manage
the active document and connected data sources. Read the following topics for detailed
instruction:
l Label Properties
3.6.1 Label Properties

Label Properties editor selects the printer, sets label dimensions, and defines the printing
paper properties.
The label properties settings are listed below and appear as dialog tabs:
Label Property Description

Printer Selects the preferred printer.
Label Dimensions Defines the Unit of measure and label dimensions.
Paper Defines the printing paper properties.
Stocks Selects the stock type.
Style Defines the label style parameters.
Info Inserts the label description.
Allow you to override the default variable settings and add
Custom Scripts
special parameters or commands.
46
TIP: To open the Label Properties Editor, double-click the design surface.
3.7 Context Menus

In ZebraDesigner for Developers, right-click displays various context menus that contain
commonly used commands. The availability of commands depends on the selected items –
design surface or object.
3.7.1 Design Surface Context Menu

When right-clicking the design surface, a context menu appears. The context menu includes
commonly used commands:
l Document Properties: opens the dialog.

l Paste: pastes clipboard contents on the design surface. Multiple reuse of a single
clipboard item is allowed.
l Cut: removes the selected element(s) from the design surface and adds it to the
clipboard to be pasted elsewhere.
l Copy: copies the selected object to the clipboard.
l Select all: selects all objects on the design surface.
l Alignment and Gridlines: allows you to define how the objects take their positions
on the design surface.
l Align to objects: makes the object on the design surface align with other
objects. When two objects are aligned, a leading line appears linking the edges
of the two aligned objects.
47
lAlign to grid: makes the object on the design surface align with gridlines.
When moving the object, it always snaps to the gridline.
l Do not align: allows you to move the objects freely.
l Display gridline guides: makes the gridlines visible.
l Objects markers visibility: toggles visibility for the object properties. Markers
become visible when moving the mouse pointer over the object.
l Object name: marker shows the name of an object.
l Internal element: marker shows if the selected object belongs to the internal
printer elements.
l Zoom: defines zooming behavior.
l Zoom to Document: shows the entire label in the ZebraDesigner for
Developers window.
l Zoom to Objects: shows all objects in the ZebraDesigner for Developers
window.
3.7.2 Object Context Menu

When right-clicking an object, a context menu appears. The context menu includes the
following commands:
l Properties: opens object properties dialog.

l Copy: copies the selected content to the clipboard.
l Cut: removes the selected element from the design surface and adds it to the
clipboard to be pasted elsewhere.
l Delete: removes the selected object from the design surface.
l Lock/Unlock: prevents the selected object from being moved or re-enables moving.
l Arrange: positions the objects so that they appear either in front of or behind each
other.
l Send Backward: sends the element back for one level.
l Send to Back: sends the element behind all other elements on the label.
l Bring Forward: brings the element forward for one level.
l Bring to Front: sends the element in front of all other elements on the label.
3.7.3 Group Context Menu

When right-clicking a group of objects, a context menu appears. The context menu includes
the following commands:
l Properties: opens common group properties dialog.

l Copy: copies the selected content to the clipboard.
l Cut: removes the selected group from the design surface and adds it to the clipboard
to be pasted elsewhere.
l Delete: deletes the selected object(s) from the design surface.
48
l Lock/Unlock: prevents the selected group from being moved or re-enables moving.
object.
l Ungroup objects: separates previously grouped objects.
l Arrange group defines how the group position according to other objects or groups.
l Send Backward: moves the selected group down one level.
l Send to Back: moves the selected group to the bottom of the object stack.
l Bring Forward: moves the selected group up one level.
l Bring to Front: moves the selected group to the top of the object stack.
l Align group allows setting the alignment and spacing for objects on the design
surface. All objects can be aligned according to the neighboring object or according
to the document border.

l Left: aligns the selected objects with the left edge of the leftmost object or
with the left edge of the first selected object. If a single object is selected, it is
placed on the label's left border.
l Center Horizontally: aligns the selected objects with the horizontal center of
the largest selected object or with the horizontal center of the first selected
object. If a single object is selected, it is placed in the horizontal center of a
label.
l Right: aligns the selected objects with the right edge of the rightmost object
or with the right edge of the first selected object. If a single object is selected,
it is placed on the label's right border.

l Top: aligns the selected objects with the top edge of the topmost object or
with the top edge of the first selected object. If a single object is selected, it is
placed on the label's top border.
l Center Vertically: aligns the selected objects with the vertical center of the
largest selected object or with the vertical center of the first selected object. If
a single object is selected, it is placed in the vertical center of a label.
l Bottom: aligns the selected objects with the bottom edge of the lowest object
or with the bottom edge of the first selected object. If a single object is
selected, it is placed on the label's bottom border.
49
4 Label
Label works as a template to add label objects and print using any kind of printing media.
Each object adds a different kind of content such as text, line, ellipse, barcode or rectangle
to a label. The content is either fixed (manually entered by the user) or dynamic (defined
using values from connected data sources).
After finishing your label template layout, you can store the template on your printers.
4.1 New Label Setup Wizard

Label Setup Wizard guides you through the process of creating a new label. The wizard
consists of four configuration steps and a summary:
l Step 1: Select the Printer

l Step 2: Set the Page Size
l Step 3: Select the Label Layout
l Step 4: Specify the Label Dimensions
l Step 5: Summary
After finishing these steps, the label is ready for editing.
NOTE: To quit Label Setup Wizard during any step, press <Escape>. The new label
properties are set to default.
4.1.1 Step 1: Select the Printer

This step selects the printer to be used for printing the newly created label. It also provides
direct access to printer driver properties.
1. Select the printer from the dropdown list.
2. Label setup wizard remembers the last selected printer. When creating another new
label, the wizard will automatically select the printer that you selected for your last
created label. If this printer is currently missing, your default printer is selected.
50
4.1.2 Step 2: Set the Page Size
This step defines how the page size is selected. When using a thermal printer, it is
recommended to set the size automatically. Manual selection proves to be useful if you know
the exact stock code or label format.
NOTE: When changing the printer, the Page Size settings always go to default
(automatic).
1. Select print media.
l Print on a roll of labels option prints on the installed roll of labels. Page size
for thermal printers is detected automatically.
NOTE: If a thermal printer is selected in the preceding Select the Printer

wizard step, this option is enabled by default.
l Print on a sheet of paper option prints labels on sheets of paper. It lets you
manually define the label page size to fit the printer.
With this option selected, additional settings appear:
l Unit of measure: defines the unit of measure to be used while designing

the label.
l Paper: defines the label page Width and Height.
2. Select stock.
Load settings from a predefined stock option sets the page to be defined by the
selected stock type.
l Stock: defines which stock type should be used when designing and printing
the newly created label. Stock types are usually associated with printer
vendors or stationery suppliers. Select the exact stock from the dropdown
menu.
If the selected stock is not compatible with printer, a warning appears. Label
designing and printing is disabled.
l Stock information: displays the selected stock's properties.
51
4.1.3 Step 3: Select the Label Layout
This step defines the label orientation and rotation on a printer:
l Orientation: sets the new label layout as Portrait or Landscape.

l Rotated: rotates the Printer Layout of a label by 180 degrees, if the selected printer
supports it.
l Preview field: displays the label layout according to the currently set properties.
4.1.4 Step 4: Specify the Label Dimensions

This step defines the dimensions of the newly created label, its margins, measurement unit,
and labels across positioning settings:
l Unit of measure: defines the unit to be used while designing the label.
l Label Dimensions: define the new label's Width and Height.
l Margins: define the distance between the edge of the printing surface and the edge
of the label (left/right, top/bottom).
l Labels Across: defines the number of labels to be printed on a single label sheet.
l Horizontal count: number of labels in a row.
l Vertical count: number of labels in a column.
l Horizontal gap: sets horizontal distance between the labels on a sheet.
l Vertical gap: sets vertical distance between the labels on a sheet.
l Processing order: defines the direction in which the labels are printed. Set the
starting corner where the printing starts and define the horizontal and vertical
direction of label positioning.
4.1.5 Step 5: Summary

This step summarizes the new label properties as defined using the Label Setup Wizard.
Before clicking Finish to enter the label editing and printing phases, check the displayed
settings:
l Printer: selected printer for label printing.

l Label dimensions: dimensions of newly created label.
l Paper dimensions: dimensions of printable paper.
4.2 Label Properties

paper properties.
52

Paper Defines the printing paper properties.
Custom Scripts
4.2.1 Printer
Printer dropdown menu lets you select a printer from the currently available printers.
TIP: To set the printer settings, select a printer and click Printer properties. This button
gives direct access to the selected printer's driver and its settings.
53
4.2.2 Label Dimensions
Label Dimensions tab specifies label dimensions and defines whether its size should adapt
to the changing size of the objects or not.
Unit of measure defines the unit to be used while designing the label. There are four
available units: cm, in, mm, and dot.
Label Dimensions group defines the label's Width and Height. Label dimension settings
become active if manual label dimensions are enabled.
When manually inserting the unit of measure, this also changes the currently defined Unit.
Margins group sets the distance between the edge of the printing surface and the edge of
the label (left/right, top/bottom).
Radius group enables you to make the label corners rounded.
l Vertical radius: adjusts corner roundness value in vertical direction.

l Horizontal radius: adjusts corner roundness value in horizontal direction.
Labels Across defines the number of labels to be printed on a single label sheet.
l Horizontal count: number of labels in a row.

l Vertical count: number of labels in a column.
l Horizontal gap: horizontal distance between labels on a sheet.
l Vertical gap: vertical distance between labels on a sheet.
l Processing order: defines the direction in which labels are printed. Set the starting
corner in which printing starts, and the horizontal/ vertical directions of label
positioning.
4.2.3 Paper
Paper tab sets printing paper properties.
Unit selects the Unit of measure to be used in a label.
Paper Type group defines paper dimensioning type – automatic or manual.
l Automatically set page size based on the label dimensions (labels on a roll): page
size is defined by the printer driver.
l Manually set page size (sheets of paper): page size is set manually.
If the page size is defined manually, additional options appear:
l Paper: selection of standard paper formats.

l Width and Height: custom paper dimensions.
54
Orientation group sets the new label layout as Portrait or Landscape.
l Rotated: Printer Layout is rotated by 180 degrees.
Preview displays current label screen and print layouts.
4.2.4 Stocks
Label stocks are a time-saving alternative to designing labels from scratch. Use stock
templates when designing labels for a specific printer type and when optimizing the label
designing process.
Stocks group defines which stock type should be used when designing and printing a label.
Stock types are usually associated with printer vendors or stationery suppliers.
NOTE: Here defined stock properties override the manually set label properties.
Stock defines the exact stock to be used for label designing and printing. Stocks are sorted
by vendors and media formats. Expand stock provider and select a specific stock type.
TIP: Use Search... to easily find the requested stock. Partial search is available – enter a
sequence of characters and all stocks which contain that sequence will be listed. If the
selected stock is not compatible with the selected printer, a warning appears. Previously
selected stock becomes active again (if it was defined) allowing the printing to continue.
NOTE: If the selected stock is not compatible with the selected printer, a warning
appears. Previously selected stock becomes active again (if it was defined) allowing the
printing to continue.
Stock information displays the selected stock's properties:
l Label dimensions
l Labels across
l Description
l Author
4.2.5 Style
Style tab is used for defining label style properties.
Background color: sets the color of label background.
55
Background picture: sets the label background picture.
l Picture file name: defines the image file to be used as background picture.
l Embed picture in a document: saves picture into the label file.
l Save embedded picture to file: the embedded label picture is saved to a separate
file.
l Remove embedded picture: embedded picture is removed from the label file.
l Picture position: sets picture position on the label.
l Center: centers the picture on the label with its original dimensions. A picture
larger than the label will display only the central part leaving the rest out of
view.
l Fit: resizes the picture to fill the label while keeping the original aspect ratio.
l Stretch: stretches picture to make it fill the entire label.
NOTE: This option ignores the original aspect ratio of the picture. The
picture might appear distorted on the label.
l Rotation: allows you to rotate the background picture in steps of 90 degrees.

l Print background picture: background picture is printed.
4.2.6 Info
Info tab includes a Description that serves as a hint or as a guide for the user that is going
to work with the label.
Define label Description by entering text into the field.
4.2.7 Custom Scripts

Custom Scripts allow you to add Zebra Programming Language (ZPL) parameters and
commands to the data stream when storing your label templates. This means that when you
finish designing the template, and store the template to your printer's memory, custom
scripts can execute additional actions.
Depending on your requirements, you can use the custom scripts as a header or footer
scripts.
l Use header/footer script allows you to add custom script to the data stream when
storing your label template.
NOTE: You can use custom header/footer scripts in combination with script definitions
that you add to the variable values on your templates.
56
EXAMPLE:
^FX[Fonts]^FS
^FX[Graphics]^FS
^FX[Format]^FS
<my header script>

CT~~CD,~CC^~CT~
^XA
^DFE:XML-SPEC.ZPL^FS
~TA000~JSN^LT0^MNW^MTT^PON^PMN^LH0,0^JMA^PR6,6^MD15^LRN^CI0
^MMT
^PW831
^LL0406
^LS0
^FT196,67^A0N,28,28^FB56,1,0^FH\^FN2^FDXML1^FS
<my variable script>

^XZ
<my footer script>
NOTE: This option is for advanced users only. The use of custom scripts requires in-
depth knowledge of ZPL.
4.3 Label Objects

After setting the label properties, it's time to start adding content to the label. Label objects
are basic design items that are used for adding and editing various content types. Each
object has its own function as described in the table below.
Label Object Icon Description
Container for textual content. It adapts its dimensions to

Text fit the amount of entered characters. When typing, text
object grows horizontally and/or vertically.
57
Label Object Icon Description
Container for textual content. It can either adapt its height

Text box to the content or make the font increase or decrease to
fit into the object frame.
Object for adding and editing various types of barcodes

Barcode
on a label.
Picture Object for adding graphic content to a label.
Rectangle Object for creating rectangular shapes on a label.
Line Object for creating lines on a label.
Ellipse Object for creating circular shapes on a label.
Inverse Object for inverting the color of the underlying object.
4.3.1 Text
Text object is a container for textual content which adapts its dimensions to fit the amount
of inserted characters. When typing, text object grows horizontally and/or vertically.
4.3.1.1 Source
Connected data source defines the content source of the selected object.
l Variables: predefined variable values which are used as object content.
Content field allows you to type the object content.
58
NOTE: When connecting your Text object to a variable, keep one of the selected internal
printer fonts. Changing to one of the TrueType or OpenType fonts returns an error that
results from using the variable Text object as graphic.
4.3.1.2 Style
Font color sets text font and underline color.
Font selects the typeface. Fonts are divided into two groups: OpenType fonts and Printer
fonts.
NOTE: If the currently selected printer is a thermal printer, additional fonts become
available. These are the internal Printer fonts that are installed on the printer. Printer
fonts are identified by the printer icon in front of their names.
The font may appear Bold, Italic, Underlined or as a Strikethrough text.
Font Scaling sets the font stretch factor. If the factor is set to 100 %, font appears in normal
scale. If the factor is set to 200 %, font appears twice as wide. If set to 50 %, font width is
shrunk to half its size.
Alignment defines horizontal positioning of the entered content.
l Left: text aligned with the left object border.

l Center: text positioned in the center of the object.
l Right: text aligned with the right object border.
l Justified: distributes text evenly along both sides.
Spacing sets the space between text characters and lines.
l Line spacing: space between each line in a paragraph.

l Character spacing: space between individual characters.
4.3.1.3 Effects
Inverse: inverted text and object background colors.
4.3.1.4 Position
Position tab defines object positioning and its position-related behavior.
Position group defines the object's position.
l X and Y: anchoring point coordinates.
59
Size group gives information about the object's dimensions.
l Width and Height: horizontal and vertical object dimension.

l Keep aspect ratio: simultaneous changing of object dimensions while scaling.
In Text object, the size of text is determined by the font size. Object dimensions and aspect
ratio cannot be changed manually and only serve as information about its current size.
NOTE: If the measurement unit is changed in label properties, the value transforms
automatically.
Rotation angle is the object angle according to the design surface.
There are multiple ways to set the object's angle: enter the angle manually , drag the slider
or click and drag the icon on the selected object. Rotation angle and slider rotates the
object around its anchoring point. The icon rotates the object around its central point.
Anchoring point is the spot where an object is pinned to design surface. Variable size
objects increase or decrease their size in the direction that is opposite to the chosen
anchoring point.
Lock prevents the object from being moved during the design process, select under the
Design behavior group.
4.3.1.5 General
General tab identifies the object and sets its status.
Name sets a unique object ID.
NOTE: Avoid using spaces or special characters in object names.
Description allows adding notes and annotations for an object. It provides help during the
label design process.
Status group defines object visibility on print preview and on printed labels.
l Not printable: prevents the object from being printed.

l Visible: if the checkbox is not selected, the object neither appears on the print
preview nor on the printed label. The object is treated as if it does not exist.
60
4.3.2 Text Box
Text box object is a container for textual content on a label. Text box object is very similar to
the standard ZebraDesigner for Developers Text object. The difference between these two
is the presentation of textual content with variable length. Text object is always expanding
or shrinking to adapt its size to the amount of entered characters. In contrast, Text Box can
either adapt (expand/shrink) its height to the content or make the font increase or decrease
its size to fit into the object frame.
TIP: To ensure that the content fits the predefined box is especially useful when working
with variable data. No matter how long the text value is, it is always placed and displayed
on a label within the pre-designed frame.
4.3.2.1 Source
NOTE: When connecting your Text Box object to a variable, keep one of the selected
internal printer fonts. Changing a TrueType or OpenType fonts returns an error that
results from using the variable Text Box object as graphic.
4.3.2.2 Style
Font color sets text font and underline color.
Font selects the typeface. Fonts are divided into two groups: OpenType fonts and Printer
fonts.
NOTE: If the currently selected printer is a thermal printer, additional fonts become
available. These are the internal Printer fonts that are installed on the printer. Printer
fonts are identified by the printer icon in front of their names.
The font may appear Bold, Italic, Underlined or as a Strikethrough text.
Font Scaling sets the font stretch factor. If the factor is set to 100 %, font appears in normal
scale. If the factor is set to 200 %, font appears twice as wide. If set to 50 %, font width is
shrunk to half its size.
Alignment defines horizontal positioning of the entered content.
61
l Left: text aligned with the left object border.
l Center: text positioned in the center of the object.
l Right: text aligned with the right object border.
l Justified: distributes text evenly along both sides.
Spacing sets the space between text characters and lines.
l Line spacing: space between each line in a paragraph.

l Character spacing: space between individual characters.
4.3.2.3 Effects
4.3.2.4 Position
Size group sets the object's dimensions:

automatically.
TIP: There are multiple ways to set the object's angle: enter the angle manually, drag the
slider or click and drag the icon on the selected object. Rotation angle and slider
rotates the object around its anchoring point. The icon rotates the object around its
central point.
anchoring point.
Lock prevents the object from being moved during the design process.
62
NOTE: If the measurement unit is changed, the value transforms automatically.
4.3.2.5 General

4.3.3 Barcode
Barcode object is used for adding various types of barcodes with encoded data to a label.
Details on barcode properties, types, and data encoding methods are available in the
dedicated Barcode section.
4.3.4 Picture
Use Picture object to add graphic content on a label. The following file formats are
supported:
l Portable Network Graphic (*.png)

l PDF (*.pdf)
l Adobe Photoshop (*.psd)
l Scalable Vector graphics (*.svg)
l Paintbrush (*.pcx)
l JPEG bitmaps (*.jpg, *.jpeg, *.jpe)
l TIFF bitmaps (*.tif, *.tiff)
l Enhanced Windows Metafile (*.emf)
l Windows Metafile (*.wmf)
l Windows bitmap (*.bmp)
4.3.4.1 Source
63
l Fixed data: manually entered fixed text.
Content field is used for entering the object content.
To (re)define the Picture object Content, click Browse and locate the file to be displayed on
the label.
Embed picture in a document stores the picture in the label file. Link to the original picture
file is discarded.
TIP: Picture embedding makes the label file more portable as the user does not have to
include the picture file when sharing the label.
Save embedded picture to file: the embedded label picture is saved as a separate file.
4.3.4.2 Style
Dithering group allows you to select the most appropriate dithering method to print
pictures on labels in black and white.
TIP: When printing pictures in black and white, dithering creates the illusion of multiple
colors and shades by varying the pattern of black dots.
Dithering type selects the dithering method:
l Printer driver default: no dithering method is selected for the picture object. When
printing in black and white, printer driver uses its own dithering method.
If no dithering is set for the picture object, the algorithm can also be selected using the
printer properties dialog. The selected dithering algorithm for an object in ZebraDesigner
for Developers overrides the algorithm selected using printer properties dialog.
l Ordered: achieves dithering by applying a threshold map (matrix with cells) on the
pixels displayed. If the value of the pixel (scaled into the 0-9 range) is less than the
number in the corresponding cell of the matrix, the algorithm plots the pixel black,
otherwise, it plots it white.
l Threshold: sets a threshold to which every pixel is compared. If the original pixel
value is higher than the threshold, it renders white. The lower the threshold value,
the higher the share of pixels turned to white.
l Floyd Steinberg: achieves dithering using error dispersion. This algorithm generates
the closest result to the original, but represents the slowest option.
4.3.4.3 Position
64

automatically.
central point.
anchoring point.
NOTE: If the measurement unit is changed, the value converts automatically.
Graphic Resizing tab is available if the picture object is connected to a variable. These
settings define how the Picture object adapts its size to the source file at print time.
l Keep original picture size: disabled picture resizing. Picture size remains
unchanged.
l Resize proportionally: proportional picture resizing. Aspect ratio of picture
dimension remains fixed.
l Resize to the designed size: horizontal and vertical picture resizing to make it fit into
the bounding box. This option will most likely make the picture distorted.
Original size displays the picture's Width and Height before resizing. Revert to original
picture size cancels the resizing actions.
65
4.3.4.4 General

4.3.5 Rectangle
Rectangle object creates a rectangular frame on a label.
4.3.5.1 Style
Outline group defines line settings:
l Thickness: object line thickness.

l Outline style: object line style.
l Solid: solid line.
l Dot: dotted line.
l Dash: dashed line.
l Erase: parts of neighboring objects become invisible underneath this object.
l Outline color: color of the line.
l Corner radius: makes the rectangle corners round. Higher values make the curve
broader.
Fill group defines the object fill settings and color.
l Fill style: object fill properties definition:

l None: completely transparent object.
l Erase: makes objects beneath the active one hidden.
l Right Diagonal: fills the object with diagonal lines that ascend toward the right
side.
66
lLeft Diagonal: fills the object with diagonal lines that ascend toward the left
side.
l Vertical: fills the object with vertical lines.
l Horizontal: fills the object with horizontal lines.
l Cross: fills the object with crossed lines.
l Cross Diagonal: fills the object with diagonally crossed lines.
l 25% of color: fill color opacity 25 %.
l Background color: object fill color definition.
NOTE: The system does not allow the Outline style and Fill style to be set to None at
the same time.
TIP: Shape objects (Rectangle, Line and Ellipse) in ZebraDesigner remember the last
used setting. Each time you add one of these objects to the label, it has the same outline
and fill settings as the previously added shape object.
4.3.5.2 Position

automatically.
central point.
67
anchoring point.
4.3.5.3 General

Printing optimization group allows activating the use of internal printer elements.
TIP: If supported by the selected printer model, a share of label element processing is
handled directly by the printer (e.g., internal fonts, shapes, barcodes). This speeds up the
printing process also due to significantly reduced data traffic.
l Use printer element if supported: prints labels using internal printer elements if the
printer allows it. If a selected printer does not support internal printer elements, the
element is sent as a graphic file.
l Always use printer element: prints labels using printer elements only. If a selected
printer does not support internal printer elements, an error message with
explanation is displayed.
l Always print as graphics: sends and prints the objects as graphic files.
NOTE: When connecting your object to a variable, enable the Use printer
element if supported or Always use printer element option. Printing in graphic
mode returns a printing error.
68
4.3.6 Line
Line object creates a line on a label.
4.3.6.1 Style

l Dot: dotted line.
4.3.6.2 Position

l Length: sets the line length.
If the measurement unit is changed in label properties, the value transforms automatically.
central point.
4.3.6.3 General
69

4.3.7 Ellipse
Ellipse object creates a circular object on a label.
4.3.7.1 Style
70
l Dot: dotted line.
Fill group defines the object fill settings and color.
l Fill style: object fill properties definition:

l None: completely transparent object.
l Erase: makes objects beneath the active one hidden.
l Right Diagonal: fills the object with diagonal lines that ascend toward the right
side.
l Left Diagonal: fills the object with diagonal lines that ascend toward the left
side.
l Vertical: fills the object with vertical lines.
l Horizontal: fills the object with horizontal lines.
l Cross: fills the object with crossed lines.
l Cross Diagonal: fills the object with diagonally crossed lines.
l Background color: object fill color definition.
NOTE: The system does not allow the Outline style and Fill style to be set to None at
the same time.
4.3.7.2 Position
71

automatically.
central point.
anchoring point.
4.3.7.3 General

72
4.3.8 Inverse
4.3.8.1 About
Inverse object inverts the underlying object's color.
4.3.8.2 Position
73

automatically.
central point.
anchoring point.
4.3.8.3 General

74
4.4 Working with Objects

This section describes how to work with objects and blend them with the design of a label.
Object is a basic building block of any label. Each object is dedicated to a specific type of
content. See the related topics for style and content related object properties.
These are the common actions for multiple object types:
l Adding an object: adds an object to the design surface.

l Adding an object with connected data source: click the down arrow next to the object
button and select an existing or new data source to make the newly added object
instantly connected to a dynamic data source.
l Grouping: makes multiple object behave as a single object.
l Rotating: changes the angle of a selected object.
l Aligning: make the object positions.
4.4.1 Adding Objects

There are multiple methods to add an object to a label. Use the most convenient one:
l Click and Click: click the object in the object toolbox. Mouse cursor transforms. Click
on the design surface – the selected object appears where clicked.
l Click and Drag: click the object in object toolbox. Mouse cursor transforms. Click on
the design surface and drag to define the size of the added object.
Text object's size cannot be defined using this method – its size is defined dynamically.
75
l Drag and Drop: click the object in the object toolbox and drag it to the design
surface. The selected object appears where the mouse button is released.
l Copy and Paste: graphical and textual content can be pasted directly to the design
surface. The following rules apply when copying items and pasting them directly to a
label:
l Graphical content from clipboard is pasted as embedded Picture object.
l Single line text is pasted as Text object.
4.4.2 Grouping
To make multiple objects on a label behave as a single object, add them to a group. To group
objects:
l Surround the objects you wish to group using mouse. A rectangle appears marking
the selected objects. Right-click and select Group objects to create a group of
objects.
l Hold <Shift> key and click the objects you wish to group. This selects multiple
objects – right-click and select Group objects to create a group of objects.
4.4.3 Rotating
There are two ways to set the angle of an object:
l Enter the angle manually in degrees or drag the slider. The object rotates around its
anchoring point. Rotation commands are accessible in two ways:
l Click Position in the Positioning group of the Design tab.
l Go to Object properties -> Position -> Rotation angle.
76
l Click and drag the icon next to the selected object. The icon rotates the
object around its central point.
Anchoring point is the spot where an object is pinned to the design surface. Variable size
anchoring point.
77
5 Creating Receipt-Style Labels
Receipts are an essential part of the purchasing process. When your customers make
purchases, they expect professional looking receipts that include standard pieces of
information such as purchased items, prices, and sum totals. Your receipts should also
include company names, addresses, and transaction details.
ZebraDesigner for Developers helps you design your receipts using dedicated receipt-style
label files. Designing your receipts this way saves you time by ensuring your receipts always
contain information customers need and print correctly during purchases.
Receipt-style labels include the following:
l Separate header, body, and footer sections for individual label files. These sections
serve as "sub-labels" and each contain predefined portions of your receipts.
l Variable label heights. Receipt-style labels adapt their sizes to the number of
purchased items. Receipt-style labels use label rolls as media.
To create and design receipt-style labels:
1. Go to File > New, and click New Receipt.

2. Complete the New Receipt Setup Wizard steps.
3. The receipt style label editing window opens.
78
4. Note the three tabs under the design surface: Header, Body, and Footer. Use these
tabs to switch between the "sub-labels" of receipts you create.
l Use the Header tab for your company information, date of purchase, and similar
details.
l Use the Body tab to create the core content of your receipts which contain
lists of purchased items and prices.
l Use the Footer tab for sum totals, tax information, and similar details.
5. After completing your receipt designs, store the files on your printer.
NOTE: Use the label preview to visually inspect your receipt-style labels. The
preview displays header, body, and footer "sub-labels" separately.
Your stored receipts are ready to print using data retrieved from your business information
systems.
5.1 New Receipt Setup Wizard

The Setup Wizard guides you through the process of creating a new receipt style label. The
wizard consists of three configuration steps and a summary:
l Step 1: Select the Printer

l Step 2: Set the Page Size
l Step 3: Specify the Label Dimensions
l Step 4: Summary
After finishing these steps, the receipt is ready for editing and storing.
79
NOTE: To quit the Receipt Setup Wizard during any step, press Escape. The new label
properties are set to default.
5.1.1 Step 1: Select the Printer

This step selects the printer to be used for printing the newly created receipt style label.
The dialog also provides direct access to printer driver properties.
Select your printer from the drop-down list.
The setup wizard remembers the last selected printer. When creating another new receipt,
the wizard automatically selects the printer that you selected for your last created label. If
this printer is currently missing, your default printer is selected.
5.1.2 Step 2: Set the Page Size

This step defines the receipt style label page size.
Select the print media.
l Print on a roll of labels: This option prints on the installed roll of labels. Page size for
thermal printers is detected automatically.
NOTE: If a thermal printer is selected in the preceding Select the Printer wizard
step, this option is enabled by default.
Select stock.
Load settings from a predefined stock option sets the page to be defined by the selected
stock type.
l Stock: defines which stock type should be used when designing and printing the
newly created label. Stock types are usually associated with printer vendors or
stationery suppliers. Select the exact stock from the dropdown menu.
If the selected stock is not compatible with printer, a warning appears. Label designing and
printing is disabled.
l Stock information: displays the selected stock's properties.
80
5.1.3 Step 3: Specify the Label Dimensions
This step defines the dimensions of the newly created label, its margins, measurement unit,
and bottom offsets:
l Unit of measure: Defines the unit to be used while designing the label.
l Label Dimensions: Define the new receipt's Width. Height settings are disabled
because the receipts use paper rolls with variable height.
l Margins: Define the distance between the edge of the printing surface and the edge
of the receipt (left/right, top/bottom).
l Botton offset: Defines the amount of empty space between the last object on your
receipt, and the bottom edge of the "sub-labels" that belong to your receipt (header,
body, or footer).
5.1.4 Step 4: Summary

This step summarizes the new receipt style label properties as defined using the Label
Setup Wizard.
Before clicking Finish to enter the label editing and printing phases, check the displayed
settings:
l Printer: Your selected printer for designing and storing the receipt.
l Label dimensions: Dimensions of the newly created receipt.
l Paper dimensions: Dimensions of printable paper.
5.2 Receipt Style Label Properties

paper properties.

Custom Scripts
81
5.2.1 Printer
Printer dropdown menu lets you select a printer from the currently available printers.
TIP: To set the printer settings, select a printer and click Printer properties. This button
gives direct access to the selected printer's driver and its settings.
5.2.2 Label Dimensions

Label Dimensions tab specifies the receipt dimensions and defines whether its size should
adapt to the changing size of the objects or not.
Unit of measure defines the unit to be used while designing the label. There are four
available units: cm, in, mm, and dot.
Label Dimensions group defines the label's Width. Height settings are disabled because
the receipts use paper rolls with variable height.
When manually inserting the unit of measure, this also changes the currently defined Unit.
Margins group sets the distance between the edge of the printing surface and the edge of
the label (left/right, top/bottom).
Bottom offset defines the amount of empty space between the last object on your receipt,
and the bottom edge of the "sub-labels" that belong to your receipt (header, body, or
footer).
5.2.2.1 Custom Scripts

Custom Scripts allow you to add Zebra Programming Language (ZPL) parameters and
commands to the data stream when storing your label templates. This means that when you
finish designing the template, and store the template to your printer's memory, custom
scripts can execute additional actions.
Depending on your requirements, you can use the custom scripts as a header or footer
scripts.
l Use header/footer script allows you to add custom script to the data stream when
storing your label template.
82
NOTE: You can use custom header/footer scripts in combination with script definitions
that you add to the variable values on your templates.
EXAMPLE:
^FX[Fonts]^FS
^FX[Graphics]^FS
^FX[Format]^FS
<my header script>

CT~~CD,~CC^~CT~
^XA
^DFE:XML-SPEC.ZPL^FS
~TA000~JSN^LT0^MNW^MTT^PON^PMN^LH0,0^JMA^PR6,6^MD15^LRN^CI0
^MMT
^PW831
^LL0406
^LS0
<my variable script>

^XZ
<my footer script>
NOTE: This option is for advanced users only. The use of custom scripts requires in-
depth knowledge of the ZPL.
5.2.3 Stocks
Label stocks are a time-saving alternative to designing labels from scratch. Use stock
templates when designing labels for a specific printer type and when optimizing the label
designing process.
Stocks group defines which stock type should be used when designing and printing a label.
Stock types are usually associated with printer vendors or stationery suppliers.
NOTE: Here defined stock properties override the manually set label properties.
83
Stock defines the exact stock to be used for label designing and printing. Stocks are sorted
by vendors and media formats. Expand stock provider and select a specific stock type
TIP: Use Search... to easily find the requested stock. Partial search is available – enter a
sequence of characters and all stocks which contain it will be listed. If the selected stock
is not compatible with the selected printer, a warning appears. Previously selected stock
becomes active again (if it was defined) allowing the printing to continue.
5.2.4 Style
Style tab is used for defining label style properties.
Background color: sets the color of label background.
Background picture: sets the label background picture.
l Picture file name: defines the image file to be used as background picture.
l Embed picture in a document: saves picture into the label file.
l Save embedded picture to file: the embedded label picture is saved to a separate
file.
l Remove embedded picture: embedded picture is removed from the label file.
l Picture position: sets picture position on the label.
l Center: centers the picture on the label with its original dimensions. A picture
larger than the label will display only the central part leaving the rest out of
view.
l Fit: resizes the picture to fill the label while keeping the original aspect ratio.
l Stretch: stretches picture to make it fill the entire label.
NOTE: This option ignores the original aspect ratio of the picture. The
picture might appear distorted on the label.
l Rotation: allows you to rotate the background picture in steps of 90 degrees.

l Print background picture: background picture is printed.
5.2.5 Info
Info tab includes a Description that serves as a hint or as a guide for the user that is going
to work with the label.
Define label Description by entering text into the field.
84
6 Barcode
ZebraDesigner for Developers supports a wide variety of 1D and 2D barcode types to be

printed on labels. Each barcode type is configurable according to specific standards.
TIP: When encoding the barcode content, make sure the used characters, length, and
identifiers comply with the barcode standard guidelines.
The following barcode types are available in ZebraDesigner for Developers:
l 1D and 2D Barcodes
l GS1 DataBar Barcode Subtypes
In ZebraDesigner for Developers, barcodes are added to a label using the barcode object.
To properly encode the data and to set the barcode object properties, read the sections
below. Each of these sections describes barcode object properties. To start editing them,
double-click the object to open the Object Properties Window.
6.1 Source
NOTE: When connecting your Barcode object to a variable, keep using the barcode as
internal printer element. Changing the barcode to a graphic returns an error.
6.2 Barcode
Barcode Type defines the specific barcode type which should be used to encode the data.
85
TIP: Code128 barcode type is selected by default. For more details about the available
barcode types, see section Barcode Types and Available Settings.
l X dimension: width of the narrowest bar in the barcode.

l Height: barcode's vertical dimension.
l Ratio defines the ratio between the barcode's narrow and wide bar widths.
Each barcode type's range of permitted ratios is limited by the standard.

ZebraDesigner for Developers only allows you to use valid ratios. By default, the ratio
is set to 3. This means that the wide bar is 3 times the width of a narrow bar.
NOTE: The available ratios depend on the selected X dimension. If you are
changing the X dimension, this also affects the selection of available ratios.
l Row height defines the height of a single data row in 2D barcodes. Row height is
specified as a multiple over the X dimension. For example, "3x" means that the row is
3 times the X dimension.
Actual properties based on selected printer displays the X dimension as it would appear
printed on a label using the currently selected printer.
Color defines the color of the barcode.
6.3 Check Digit

Check digit is used by any scanning system to verify that the number scanned from a
barcode is read correctly.
TIP: Check digit is derived from the preceding barcode digits and is placed as the final
digit of a barcode.
Include check digit determines if check digit is included in a barcode or not.
l Auto-generate check digit: automatic check digit calculation.
If the data already includes invalid check digit, ZebraDesigner for Developers replaces it
with a proper value.
l Verify the provided check digit: verification of the manually provided check digit. An
error message appears if the check digitis incorrect.
86
l Display check digit in human readable: check digit included in the human readable
barcode text.
6.4 Human Readable

Human Readable text displays readable barcode data content located below or above the
barcode. Its role is to provide backup in case the barcode is damaged or of poor quality.
NOTE: Human Readable tab is visible with supported barcode types.
l No human readable: barcode is rendered without human readable text.

l Above barcode: human readable text is located above the barcode.
l Below barcode: human readable text is located below the barcode.
Style group allows you to set custom properties for human readable text.
NOTE: If you decide to customize human readable text, barcode can no longer be used as
internal printer element. It is sent to printer and printed as a graphic element.
l Custom Font: enables font and font size selection. Internal printer fonts cannot be
used as custom human readable font.
l Auto font scaling: If enabled (default setting), human readable text grows or shrinks
proportionally along with the changing size of the barcode. To set a custom size for
human readable text, disable this option and select the appropriate font size.
l Bold: makes human readable text appear bold.
l Italic: makes human readable text appear italic.
Mask group sets the format of the input data before it is displayed on a label.
l Content mask sets the format of the input data before it is displayed on a label.
l Mask character is a character used in the mask that is replaced with actual data on
the printed label.
EXAMP LE
A use r n e e ds t o format a ph on e n umbe r t o be more re adable on t h e labe l.

D at a in put is n ot format t e d sin ce it is re ad from a dat abase .
If t h e in put value re ad from a dat abase is:
+38642805090
87
an d t h e con t e n t mask is:
(****) **** - ****
t h e re sult in g out put is:
(+386) 4280 - 5090
If t h e dat a con t ain s t h e ast e risk "*" ch aract e r, ch an ge t h e Mask c har ac ter .
Th e ch aract e r sh ould h ave a un ique value t h at doe s n ot appe ar an ywh e re
in t h e dat a.
6.5 Bearer Bar

Bearer bar is a border that surrounds the barcode. Its purpose is to protect the barcode
image and to enhance reading reliability.
l Fixed thickness: automatically defined bearer bar width.

l Variable thickness: user-defined bearer bar width.
l Thickness multiplier: bearer bar width factor.
l Show vertical bar: vertical bearer bars displayed or hidden.
6.6 Details
Details differ according to the barcode standards. Define the options that are given with
regard to the currently selected barcode type. Details for 1D and 2D barcodes are
described in dedicated sections:
6.7 Position
88

automatically.
central point.
anchoring point.
automatically.
6.8 General
89

6.9 Available Barcodes and Their Settings
Barcode Example Info Available Settings

Basic Barcode Set-
tings
Variation of Plessey Human Readable
Code. Used for point of Details tab:
Anker
sale systems prior to the
advent of EAN code. Include quiet
zones
Space correction
90
Basic Barcode
Settings
Type of EAN barcode Human Readable

Bookland used exclusively for Details tab:
books. Include quiet
zones
Space correction
A self-checking and bin- Basic Barcode

ary level linear barcode Settings
symbology with no check
Human Readable
Codabar sum digit appended.
Details tab:
Widely used in libraries
and package delivery sys- Include quiet
tems. zones
Basic Barcode
Settings
43 characters allowed. Human Readable
ASCII character set sup- Details tab:
Code93
ported by using com-
binations of 2 characters. Include quiet
zones
Space correction
Basic Barcode
Settings
Double density data Human Readable

Code128 encoding, ASCII char- Details tab:
acter set supported. Include quiet
zones
Space correction
ASCII characters 00 to 95 Basic Barcode

Code128-A (0-9, A-Z, and control Settings
codes), special char- Human Readable
91
Details tab:
acters, and FNC 1-4 sup- Include quiet

ported. zones
Space correction
Basic Barcode
Settings
ASCII characters 32 to Human Readable
127 (0-9, A-Z, a-z), special Details tab:
Code128-B
characters, and FNC 1-4
supported. Include quiet
zones
Space correction
Basic Barcode
Settings
00-99 (encodes each two Human Readable

Code128C digits with one code) and Details tab:
FNC1. Include quiet
zones
Space correction
Basic Barcode
Settings
Check Digit
Human Readable
Fully alphanumeric bar- Details tab:
Code-39 code for use with data-
entry systems. Include quiet
zones
Inter character
gap
Space correction
92
Basic Barcode
Settings
Check Digit
Human Readable
28 ASCII character set Details tab:
Code-39 full
including asterisks sup-
ASCII Include quiet
ported.
zones
Inter character
gap
Space correction
Basic Barcode
Settings
Check Digit
Human Readable
Code-39 Tri Computer tape cartridge Details tab:
Optic marking. Include quiet
zones
Inter character
gap
Space correction
Basic Barcode
Settings
Check Digit
Numbering system for
shipping containers that Human Readable
Dun-14
uses other barcode Details tab:
types.
Include quiet
zones
Space correction
93
Basic Barcode
Settings
Check Digit
Human Readable
Details tab:
European Article Number,
Ean-13 Include quiet
used for global retail.
zones
Descender bar
Include EAN white
space
Space correction
Basic Barcode
Settings
Check Digit
Human Readable
Often used on news- Details tab:
Ean-13 + 2
papers and magazines. Include quiet
zones
Descender bar
Include EAN white
space
Basic Barcode
Settings
For books in English lan-
guage: the first digit of Check Digit
the EAN-5 is the currency
Human Readable
Ean-13 + 5 indicator. The four fol-
Details tab:
lowing digits represent
the price multiplied by Include quiet
100. zones
Descender bar
94
Include EAN white
space
Basic Barcode
Settings
Check Digit
Human Readable
Ean-14 Traded goods.
Details tab:
Include quiet
zones
Space correction
Basic Barcode
Settings
Check Digit
Human Readable
Details tab:
Small package marking
Ean-8 where an EAN-13 bar- Include quiet
code would be too large. zones
Descender bar
Include EAN white
space
Space correction
Basic Barcode
Settings
Check Digit
Only used if the article is
Human Readable
Ean-8 + 2 too small for an EAN-13
Details tab:
code.
Include quiet
zones
Descender bar
95
Include EAN white
space
Basic Barcode
Settings
Check Digit
Human Readable
Only used if the article is Details tab:
Ean-8 + 5 too small for an EAN-13
code. Include quiet
zones
Descender bar
Include EAN white
space
Basic Barcode
Settings
A variant of Code 128 - it Human Readable
automatically inserts a Details tab:
GS1-128
FNC1 character after the
initial character. Include quiet
zones
Space correction
Basic Barcode
Settings
Check Digit
Used on 135 film, for ITF-
Interleaved 2 of 5 Human Readable
14 barcodes, and on
Details tab:
packaging.
Include quiet
zones
Space correction
Higher level packaging. Basic Barcode

ITF 14
GTIN included. Settings
96
Check Digit
Human Readable
Bearer Bar
Details tab:
Space correction
Basic Barcode
Settings
Check Digit
Higher level packaging.
ITF 16 Human Readable
GTIN included.
Bearer Bar
Details tab:
Space correction
Basic Barcode
Settings
Used primarily for invent- Check Digit

ory control, marking stor-
Human Readable
MSI age containers and
Details tab:
shelves in warehouse
environments. Include quiet
zones
Space correction
Identification in logistics. Basic Barcode

The code includes an Settings
extension digit, a GS1
SSCC Human Readable
company prefix, a serial
Details tab:
reference, and a check
digit. Space correction
One of the first barcode Basic Barcode
symbologies. Still used in Settings
Plessey
libraries and for shelf
tags in retail stores. Check Digit
97
Human Readable
Details tab:
Include quiet
zones
Space correction
Basic Barcode
Settings
Identification in logistics.
Check Digit
The code includes an
extension digit, a GS1 Human Readable
SSCC-18
company prefix, a serial Details tab:
reference, and a check
Include quiet
digit.
zones
Space correction
Basic Barcode
Settings
Used for cartons, cases, Check Digit

or pallets that contain
Human Readable
Upc Case Code products with UPC or
Details tab:
EAN product iden-
tification number. Include quiet
zones
Space correction
Basic Barcode
Settings
Check Digit
Product identifying at
Human Readable
Upc-A retail checkout. GTIN
Details tab:
included.
Include quiet
zones
Descender bar
98
Space correction
Basic Barcode
Settings
Product identifying at Check Digit

retail checkout. GTIN
Human Readable
Upc-A + 2 included. Used with
Details tab:
magazines and peri-
odicals. Include quiet
zones
Descender bar
Basic Barcode
Settings
Check Digit
Product identifying at
retail checkout. GTIN Human Readable
Upc-A + 5
included. Used for book Details tab:
pricing.
Include quiet
zones
Descender bar
Basic Barcode
Settings
Check Digit
Product identifying at Human Readable

retail checkout. GTIN Details tab:
Upc-E (compressed) included.
Include quiet
Adapted for smaller pack-
zones
ages.
Descender bar
Space correction
Symbology
99
Basic Barcode
Settings

Human Readable
Upc-E + 2 (compressed) included.
Details tab:
ages. Include quiet
zones
Descender bar
Basic Barcode
Settings

Human Readable
Upc-E + 5 (compressed) included.
Details tab:
ages. Include quiet
zones
Descender bar
Tracking and sorting of Details tab:

USPS Intelligent letters and flat packages
Mail Barcode Include quiet
in the United States.
zones
6.9.1 2D Barcodes

Basic Barcode Settings
High capacity, sym-
bol size adjusts Details tab:
automatically Code page
Aztec
depending on the
amount of input Data layer
data.
Error correction level
100
Details tab:
High capacity,
Data Matrix optimal for small Format
packages. Encoding
Code page
Marking products
that cross Available settings change
GS1
POS applications. according to the selected
DataBar
GS1 identification GS1 DataBar type.
(AIs) included.
Added GS1 Applic- Details tab:
ation Identifiers
GS1 Format
and ASC MH10
Datamatrix
Data Identifiers and Encoding
maintenance.
Code page

Details tab:
Added GS1 Applic-
ation Identifiers Symbol version
GS1 QR
and ASC MH10
Code Error correction level
Data Identifiers and
maintenance. Encoding
Code page
Used by UPS on
shipping labels for
MaxiCode world-wide Basic Barcode Settings
addressing and
package sortation.
Reduced size and
capacity of a nor-
Details tab:
mal QR code.
Micro QR
Optimal when the Symbol version
barcode size needs
to be minimized.
101
Encoding
Code page

Details tab:
Compact version of Code page
MicroPDF
PDF-417.
Compaction mode
Version

Details tab:
Commonly used in
Code page
transport, invent-
ory management, Compaction mode
PDF-417 etc. The code is
both self-checking
and bi-directionally Columns
decodable.
Rows
Truncated

A matrix barcode
Details tab:
readable by QR
scanners and Symbol version
QR smartphones.
Adaptable size to
the amount of Encoding
encoded data.
Code page
102
6.10 GS1 DataBar Subtypes
6.10.1 Linear Symbol Types
GS1 DataBar Subtype Example Info

Omnidirectional scan-
Omnidirectional ning, up to 20 trillion
encodable values.
Stacked truncated sym-
bol for omnidirectional
Stacked
scanning with reduced
symbol length.
Full height symbol

stacked in two rows
Stacked Omnidirectional
separated by a delim-
iter.
Height reduced to 13
Truncated times the X dimension.
For handheld scanners.
Expanded ning, variable content
length.
ning, variable content
length, reduced length
Expanded Stacked due to stacking (2 to 11
rows)."GS1 DataBar
Properties" on
page 109.
Limited range of values.
Limited
For handheld scanners.
103
6.10.2 Composite Symbol Types

A linear symbology
that supports omni-
directional scanning of
packages. It encodes
Omnidirectional
14 digits of numerical
data used to identify
GTIN for scanning in
the supply chain.
Stacked truncated
symbol for omni-
Stacked directional scanning
with reduced symbol
length.
Intended for very
small items in health-
Truncated
care, not intended for
POS scanners.
ning, variable content
Expanded length. Used for vari-
able-measure food,
coupons.
Omnidirectional
scanning, variable
content length,
reduced length due to
Expanded Stacked stacking (2 to 11
rows). See section
"GS1 DataBar
Properties" on
page 109
Limited range of val-
Limited ues. For handheld
scanners.
104
A smaller and
EAN-8 shortened version of
the EAN code.
EAN codes require 13

digits (12 if the check
EAN-13
digit is calculated
automatically).
GS1-128 linear bar-

EAN.UCC 128 & CC-A code linked to a 2D
barcode called CC-A.
GS1-128 linear bar-
EAN.UCC 128 & CC-C code linked to a 2D
barcode called CC-C.
The linear component
encodes the item’s
primary identification.
The adjacent 2D Com-
UPC-A posite Component
encodes sup-
plementary data, such
as a batch number and
expiration date.
PC-E compresses a
normal UPC-A code
into a six digit code by
“suppressing” the num-
UPC-E ber system digit, trail-
ing zeros in the
manufacturers code
and leading zeros in
the product number.
105
6.11 1D Barcode Details
Details tab settings vary along with the specific barcode standards.
TIP: Keep in mind the currently selected barcode type as you define the available
barcode settings.
ZebraDesigner for Developers allows setting the following 1D barcode details:
l Include quiet zones: blank space around the printed barcode. Quiet zone ensures
the highest level of scanning reliability.
NOTE: This option ensures optimum readability in case a neighboring object on a

label is located right next to the barcode.
l Inter character gap: distance between the last bar of a character and the first bar of
the next character in a barcode.
l Descender bars: makes the bars at the beginning, in the middle, and at the end of
certain barcode types (EAN and UPC) longer.
l Include EAN white space: inserts a special character ( < or >) to indicate the
EAN barcode width.
l Space correction: adds white pixels to increase the gap width between the bars.
Symbology: UPC barcode Number system:

l 0, 1 , 6, 7 and 8 are for regular UPC codes.
l 2 is for random weight items, e.g., meat, marked in-store.
l 3 is for National Drug Code and National Health related Items.
l 4 is for in-store marking of non-food items.
l 5 and 9 are for coupon use.
6.12 2D Barcode Details

2D barcodes enable multiple type-specific settings under the Details tab. When defining
these settings manually, the dropdown lists offer specific standard-compliant options.
TIP: ZebraDesigner for Developers defines the Details tab settings automatically if the
user chooses not to manually define them.
106
6.12.1 Code Page
Code page defines how the mapping of code characters with scanned characters is done.
To display the scanned data accurately, the correct code page must be selected. If none of
the code pages is selected by the user, ZebraDesigner for Developers uses system
character encoding.
6.12.2 Columns
Columns are basic vertical elements of a PDF 417 barcode. A maximum of 30 columns may
be included in a single PDF 417 symbol.
6.12.3 Compaction Mode

Compaction mode compacts a number of data characters into codewords. The decoding
algorithm uses the individual codewords to place them into a meaningful matrix.
l Binary: all 256 ASCII values (up to 1100 bytes) are allowed.
l Text: all printable ASCII characters 32–126 and ASCII 9, 10 and 13 (up to 1800
characters) are allowed.
l Numeric: encoding of numeric data (up to 2700 digits).
6.12.4 Data Layer

Data layer defines the number of data layers that encode data in an Aztec barcode. The
number of data layers correlates directly with the barcode data capacity. If the value
exceeds the data capacity provided by the selected Data layer, an error returns. One to four
data layers are allowed.
6.12.5 Encoding
Encoding defines character encoding scheme for the selected barcode.
NOTE: If you select the GS1 Datamatrix barcode, ZebraDesigner automatically sets the
encoding scheme to ASCII. This makes sure the GS1 Datamatrix barcodes on your labels
are GS1-compliant.
6.12.6 Error Correction Level

Error correction level defines the symbol security level. It adds a series of error correction
codewords to the encoded data. These codewords enable the printed symbol to withstand
damage without data loss. The higher the security level, the greater the number of data
107
layers required to contain the symbol – and hence, its overall size. If none of the Error
correction levels is selected, ZebraDesigner for Developers defines it automatically.
6.12.7 Format
Format defines the symbol size and its capacity using the number of column and row
elements.
If using Data Matrix barcode on your labels, DMRE (Data Matrix Rectangular Extension) allows
you to use multiple rectangular formats. These additional rectangular sizes increase data
encoding capacity of the barcode.
NOTE: For printers without internal DMRE support, enable Always print as graphics
under General properties to print the Data Matrix barcode successfully.
6.12.8 Rows
Rows – PDF-417 barcode symbol is made of stacks of vertically aligned rows. Such barcode
adapts its size to the amount of the encoded data and may contain from 3 to 90 rows.
6.12.9 Symbol Version

Symbol version defines the symbol data capacity. As the amount of data increases,
additional modules are required to build a QR code. This makes the symbol larger on the
printed label.
6.12.10 Truncated
Truncated reduces the PDF-417 barcode size by removing a single codeword and a stop
bar from each symbol row.
6.12.11 Version
Version defines the symbol size based on the number of columns. One-, two-, three-, and
four-column versions of Micro PDF417 barcode are available.
6.13 GS1 DataBar Specifics

In addition to the common barcode properties, the specifics described below are available
for GS1 DataBar.
108
6.13.1 GS1 DataBar Properties
GS1 DataBar Expanded Stacked subtype encodes the data in the form of symbol
segments sequence. Symbol width is defined by the number of symbol segments in each
stacked row. Symbol height is defined by the number of stacked rows and their height.
l Segments per Row defines the number of segments for each row of a symbol. Up to
22 segments are allowed per symbol.
109
7 Dynamic Data Sources
Dynamic data sources form an essential part of working with the ZebraDesigner for
Developers. They enable the use of label objects that dynamically change their content with
each printed label, if necessary.
EXAMPLE: Typical dynamic content that are automatically updated are counters, serial
numbers, date, time, weight, and article images.
To display and print the dynamic object content properly, ZebraDesigner for Developers
uses the following dynamic data types:
l Current Date: current date taken as a variable value.

l Current Time: current time taken as a variable value.
l Counter: type of variable whose value increments or decrements along with the
changing value of system or printer counter.
7.1 Variables
Variables act as containers for storing and passing data between objects, scripts, external
applications, printers, and user inputs.
l Variable: changes value at print time or according to conditions you define.
110
7.1.1 Variable
Variable (also known as prompt variable) is a type of variable that obtains its value at print
time.
7.1.1.1 General
About group of settings identifies the variable and sets its definition.
l Name: unique variable name. This name is used as the variable reference during its
use.
Avoid using non-alphanumerical characters when defining the variable name.
l Description: is a field that allows adding additional information and suggestions.
l Initial value: starting value that is assigned to a variable when created. It is defined
using one of the following methods:
l Manually entering a fixed value. Characters from any group of allowed

characters are permitted.
l Using a special character:

l Special character can be entered manually using the less than/greater
than signs, e.g. <CR>, <LF> ...
l Special character can be selected from the dropdown list.
111
ZebraDesigner for Developers supports combined values as the initial value. Read
more about combining the values here.
EXAMPLE: A combined initial value of a variable may contain a fixed value, a

dynamic data source and special characters. The order of inserted items can be set
randomly. Three options:
1. aaa123[Variable]<CR>
2. <CR>aaa123[Variable]
3. [Variable]<CR>aaa123
Make sure the inserted initial value meets the criteria defined with Output Rules for each
data type.
Provisional value defines a custom placeholder variable value in an object while designing
labels or forms. In a label object, the provisional value is replaced by the real variable value at
print time. In a form object, the real variable value appears when the form is run.
l Auto generated: generates the provisional value automatically. Disable this option to
define and use a custom provisional value.
By default, provisional value equals the initial value.
If the variable Output rules change, the provisional value format adapts accordingly.
Use one of the Special variable group options if the value of the variable contains the
printing quantity information that must be included in the stored label template.
l Use for Print Quantity: This variable value defines the number of printed labels.
When you export the label, the exported file includes this variable along with the print
command for label quantity.
l Use for Copy Quantity: The variable value tells how many identical label copies
should print. When you export the label, the exported file includes this variable along
with the print command for label copies.
l Use for Cut Quantity: The variable value tells after how many printed labels the
cutter activates. When you export the label, the exported file includes this variable
along with the cut command.
To enable using special variables with your label templates, make sure you select these two
options on your Store form:
l Operation: Store template to printer, then recall.
l Recall stream format: ZPL
112
NOTE: These two settings are mandatory. To execute various operations related to
printing quantities while recalling your templates, ZebraDesigner for Developers sends
the ZPL ^PQ command.
NOTE: The option Use var for Cut Quantity is available only if the selected printer
supports cutting.
7.1.1.2 Variable Properties
7.1.1.2.1 Input Rules
Data group defines permitted data properties.
l Limit length: maximum length of variable value.

l Fixed length: variable must contain the exact number of characters as defined in the
Limit length.
7.1.1.2.2 Output Rules
Prefix and Suffix are characters that are added to a variable value.
l Prefix: text placed in front of the variable value.

l Suffix: text placed behind the variable value.
Multiline group divides text into multiple lines.
l Number of lines: maximum number of lines for a variable value.

l Line length: maximum number of characters in a single line.
Script Definition allows you to define and add custom printer commands to the printer
stream data. Normally, ZebraDesigner for Developers processes your label template and
113
exports the appropriate printer commands to the printer. With Script Definition, you can
define additional commands and include them in the print stream file.
l Use script enables adding scripts to your print stream file.
NOTE: This option is for advanced users. Your labels might not print correctly with errors
in your ZPL scripts.
7.1.2 Current Date

Current Date is a type of variable that displays the current date value. The value is obtained
from printer clock.
7.1.2.1 General Tab

Definition group sets output formatting and displays its preview.
l Output format: format in which the date is displayed. Available date formats are listed
here.
l Output language: language selection and regional formatting for days and months.
EXAMPLE: Output Language becomes relevant when the dates that include months or
dates are written in words. In some cases, data calculations may be affected as well. For
example, in US, a new week begins on Sunday whereas in EU a new week begins on
Monday.
l Output preview: displays the printed current date. The range of used characters
adapts to the selected Output language and printer.
Date offset group enables adding a certain number of days, months or years to the current
date. The offset date is displayed in the object instead of the present date.
l Days: date offset in days.

l Months: date offset in months.
l Years: date offset in years.
7.1.2.2 Output Rules

Prefix and Suffix values may be added to a variable value if required.

114
7.1.2.3 Date Formats
ZebraDesigner for Developers enables flexible use of date fields. When defining the
formats, the following notations are used:
Notation Description
d The number of the day in a month. Occupies one or two

characters.
dd The number of the day in a month. Always occupies two characters

– leading zeros are added if necessary.
M M is the number of month. Occupies one or two characters.
MM MM is the number of month. Always occupies two characters.
yy or yyyy The year represented with 2 or 4 digit numbers.
ddd The abbreviated name of the day of the week.
dddd The full name of the day of the week.
MMM The abbreviated name of the month.
MMMM The full name of the month.
J The number of days since January 1. Occupies from one to three

characters.
JJJ The number of days since January 1. Always occupies three

characters.
W The week number in current year. Occupies one or two characters.
WW The week number in current year. Always occupies two characters.
N The weekday number. The value range takes 1–7 characters,

where 1 represents Monday and 7 represents Sunday.
Custom text Any sequence of characters is displayed unchanged. Insert dots,

commas, and other characters to present the date as required.
7.1.2.3.1 Date Format Examples
Format Printed Date (English)
d.M.yyyy 10.3.2016
dd/MM/yy 10/03/16
115
dddd, d.MMMM yyyy Thursday, 10.March 2016
JJJWWyyyy 069102005
textd/M/yyyytext text10/3/2016text
7.1.3 Current Time

Current Time is a type of variable that displays the current time value. The value is obtained
from printer clock.
7.1.3.1 General Tab

About group of settings identifies the variable and defines time output format and language.
l Name: unique variable name. This name is used as a variable reference during its use.
Definition group sets output formatting and displays its preview.
l Output format: format in which the time is displayed. Available time formats are listed
here.
l Output preview displays the printed current time format.
Time offset enables adding or subtracting a certain number of seconds, minutes or hours
from the current time.
l Seconds: time offset in seconds.

l Minutes: time offset in minutes.
l Hours: time offset in hours.

Prefix and Suffix values may be added to a variable value if required.

7.1.3.3 Time Formats

ZebraDesigner for Developers enables flexible use of time fields. Select a predefined time
format or create a customized one. When defining the formats, the following notations are
used.
Notation Description
h Hours in 12-hour format. AM/PM is added, if selected. Occupies
116
one or two characters.
hh Hours in 12-hour format. AM/PM is added if selected. Always

occupies two characters. Leading zeros are added, if necessary.
H Hours in 24-hour format. Occupies one or two characters.
HH Hours in 24-hour format. Always occupies two characters.
mm Used for minutes.
ss Used for seconds.
7.1.3.3.1 Time Format Examples
Format Printed Date
h:mm {AM/PM} 8:25PM
H:mm 20:25
hh:mm:ss 08:25:36
7.1.4 Counter
Counter is a type of variable whose value increments or decrements along with the
changing value of system or printer counter.
7.1.4.1 General Tab

About group of settings identifies the variable and defines serialization details.
l Name: unique variable name. This name is used as variable reference.

Definition group of settings defines the counter behavior.
l Counter type: counter value increasing or decreasing.

l Incremental: value increases along with the printed labels.
l Decremental: variable value decreases along with the printed labels.
l Step: amount of units that represent the next state of counter value.
l Initial value: value that is used when the counter starts.
l Preview: displays the counter value sequence.
EXAMPLE: Counter Step = 3, Repetition = 3 and Initial value = 1 are: 1, 1, 1, 4, 4, 4, 7, 7, 7,

10, 10, 10, 13, 13, 13, ...
117
Use one of the Special variable group options if the value of the variable contains the
printing quantity information that must be included in the stored label template.
l Use for Print Quantity: This variable value defines the number of printed labels.
When you export the label, the exported file includes this variable along with the print
command for label quantity.
l Use for Copy Quantity: The variable value tells how many identical label copies
should print. When you export the label, the exported file includes this variable along
with the print command for label copies.
l Use for Cut Quantity: The variable value tells after how many printed labels the
cutter activates. When you export the label, the exported file includes this variable
along with the cut command.
To enable using special variables with your label templates, make sure you select these two
options on your Store form:
l Operation: Store template to printer, then recall.
l Recall stream format: ZPL
NOTE: These two settings are mandatory. To execute various operations related to
printing quantities while recalling your templates, ZebraDesigner for Developers sends
the ZPL ^PQ command.
NOTE: The option Use var for Cut Quantity is available only if the selected printer
supports cutting.
7.1.4.2 Input Rules

Data defines the counter input criteria.
l Limit length: maximum length of a variable value.

l Length (characters): specifies the exact number of characters permitted.
118
l Fixed length: variable must contain the exact number of characters as defined in the
Limit variable length.

Prefix and Suffix are characters that are added to a variable value.

Script Definition allows you to define and add custom printer commands to the printer
stream data. Normally, ZebraDesigner for Developers processes your label template and
exports the appropriate printer commands to the printer. With Script Definition, you can
define additional commands and include them in the print stream file.
l Use script enables adding scripts to your print stream file. Type or paste your script
into the dedicated Script field.
7.2 Special Character Shortcuts

ZebraDesigner for Developers includes several predefined control characters – select them
from the dropdown menu in any dialog when text input is enabled. An arrow button on the
right side of the edit field lists the shortcuts.
EXAMPLE: FNC1 character can simply be encoded as <FNC1>.
If specific special character is not available on the list of shortcuts, see sections "Insert
Characters with <Alt>+<ASCII_code>" on page 121 and "Insert Characters with <#hex_
code> Syntax" on page 121.
ASCII code Abbreviation used in the application Description of the character

1 SOH Start of Heading
2 STX Start of Text
3 ETX End of Text
4 EOT End of Transmission
23 ETB End Transmission Block
25 EM End of Medium
5 ENQ Enquiry
6 ACK Acknowledgment
119
7 BEL Bell
8 BS Back Space
9 HT Horizontal Tab
11 VT Vertical Tab
13 CR Carriage Return
10 LF Line Feed
12 FF Form Feed
14 SO Shift Out
15 SI Shift In
16 DLE Data Link Escape
17 DC1 XON - Device Control 1
18 DC2 Device Control 2
19 DC3 XOFF - Device Control 3
20 DC4 Device Control 4
28 FS File Separator
29 GS Group Separator
30 RS Record Separator
31 US Unit Separator
21 NAK Negative Acknowledgment
22 SYN Synchronous Idle
24 CAN Cancel
26 SUB Substitute
27 ESC Escape
188 FNC Function Code 1
120
7.3 Insert Characters with <#hex_code>
Syntax
Another method of entering special characters is using the syntax <#hex_code>. The hex_
code stands for a two-character mark in hexadecimal numerical system. The appropriate
values go from 0 (decimal 0) to FF (decimal 255).
EXAMPLE: <#BC> (decimal 188) would be the same as <FNC1>, as they both would
encode the character with ASCII code 0188.
7.4 Insert Characters with <Alt>+<ASCII_

code>
This method is valid only for characters that are above ASCII code 32. A typical example
would be FNC codes that are used to encode GS1-128 barcode data. Labeling software
encodes this type of barcode according to standards – normally, you would not have to
change anything. However, sometimes it becomes necessary to manually add such
character, to label data.
To include Function Codes, enter the appropriate character for a Function Code. ASCII
codes of Function Codes are as follows:
FNC1 0188
FNC2 0189
FNC3 0190
FNC4 0191
To enter a character for FNC1, press and hold the <Alt> key and type in digits 0188 on
the numeric keyboard. Note the leading zero is mandatory. Release the <Alt> and the
FNC1 character appears.
121
7.5 Chip-based Serialization
The Serialized Global Trade Item Number (SGTIN) is the RFID equivalent to a product
barcode with the addition of a unique product serial number. The most common form of
SGTIN uses numeric serialization which uses the SGTIN-96 encoding scheme.
RFID tags contain a unique chip serial number as part of the TID field (unique ID of the
RFID tag). The chip serial number becomes part of the TID field during manufacturing, and
then permalocked. Locking makes the serial number unalterable after delivery to customers.
NOTE: Field names can vary between the different RFID tags. The TID in this case
represents a field using which you encode the serial number to the chip. Check your
RFID tag specifications to make sure you encode the serial number to the correct field.
When implementing the chip-based serialization for your products, ZebraDesigner for
Developers offers you the option to directly encode the TID unique identifier to your
RFID tag:
1. Open the RFID Tag dialog and go to the Content panel.

2. Select the EPC data field.
3. For Data type, select the Electronic Product Code (EPC).
4. For Encoding type, select SGTIN-96 or SGTIN-64.
5. For Serial Number, click Data source to open the dynamic data selector. Use the
TID value to encode your serial number into the RFID tag.
l Other options are company-specific.
NOTE: Printer driver support for RFID is required for chip-based serialization.
122
8 Glossary
AI
Application Identifier
ANSI
American National Standards Institute
BOM
Bite Order Mark
CIJ
Continuous Inkjet
CSV
Comma Separated Values
DDL
Data Definition Language
DI
Data Identifier
DMRE
Data Matrix Rectangular Extension
123
E
EAS
Electronic Article Surveillance
FNC
Barcode extension character
GTIN
Global Trade Item Number
HIBC
Health Industry Bar Code
NDEF
NFC Data Exchange Format
NFC
Near Field Communication
ODBC
Microsoft Open Database Connectivity
OLE
Object Linking and Embedding
124
P
PJM
Phase Jitter Modulation
RF
Radio Frequency
RPC
Remote Procedure Call
RTF
Rich Text Format
SCAC
Standard Carrier Alpha Code
TID
Transponder ID
UNC
Universal Naming Convention
UPC
Universal Product Code
125
W
WSDL
Web Services Description Language
126
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation,
registered in many jurisdictions worldwide. All other trademarks are the property of their
respective owners. ©2019 Zebra Technologies Corporation and/or its affiliates. All rights
reserved.
www.zebra.com

Zebradesigner For Developers User Guide: Rev-2019-1 P1109190-En

Uploaded by

Copyright:

Available Formats

Zebradesigner For Developers User Guide: Rev-2019-1 P1109190-En

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Zebradesigner For Developers User Guide: Rev-2019-1 P1109190-En

Uploaded by

Copyright:

Available Formats

ZebraDesigner for

Continuous improvement of products is a policy of Zebra Technologies. All specifications

1 Introducing ZebraDesigner for Developers 7

2.1 Basic ZebraDesigner for Developers Concepts 8

2.2 Keyboard and Mouse Support 10

2.3 Options (Configuring the Program) 11

3.1 Landing Page 13

3.2 Object and Explorer Panels 14

3.3 Printer and Status Bar 15

3.4 Tabs and Ribbons 16

3.5 Design Surface 43

3.6 Document Properties and Management Dialogs 46

3.7 Context Menus 47

4.1 New Label Setup Wizard 50

4.2 Label Properties 52

4.3 Label Objects 57

4.4 Working with Objects 75

5 Creating Receipt-Style Labels 78

5.1 New Receipt Setup Wizard 79

5.2 Receipt Style Label Properties 81

6.3 Check Digit 86

6.4 Human Readable 87

6.5 Bearer Bar 88

6.9 Available Barcodes and Their Settings 90

6.10 GS1 DataBar Subtypes 103

6.11 1D Barcode Details 106

6.12 2D Barcode Details 106

6.13 GS1 DataBar Specifics 108

7 Dynamic Data Sources 110

7.1 Variables 110

7.2 Special Character Shortcuts 119

7.3 Insert Characters with <#hex_code> Syntax 121

7.4 Insert Characters with <Alt>+<ASCII_code> 121

7.5 Chip-based Serialization 122

Text that appears in bold refers to menu names and buttons.

NOTE: This is the style of a note.

EXAMPLE: This is the style of an example.

This is the style of a best practice.

WARNING: This is the style of a warning.

TIP: This is the style of a tip.

2.1 Basic ZebraDesigner for Developers

Label object types and their purpose are listed here.

2.1.3 Design Surface

TIP: Use View tab to customize your design surface.

l Learn more about design surface elements here.

l How to efficiently use keyboard and mouse

2.2.1 Efficient Use of Keyboard and Mouse

2.2.2 Keyboard Shortcuts

2.3 Options (Configuring the Program)

Your ZebraDesigner for Developers workspace provides a flexible and easy-to-use

ZebraDesigner for Developers workspace includes the following:

3.1 Landing Page

3.2.1 Dynamic Data Explorer

3.3 Printer and Status Bar

3.4.3 File Tab

l Start: takes you to the ZebraDesigner for Developers landing page.

New from Sample Templates creates a document based on a selection of

Browse allows selecting the label on local or connected network drives.

3.4.3.6 Storing Label Templates

() -