^BXData Matrix Barcode
^BX configures data Matrix Barcode. It applies to the current field and can change pixels in the rendered label.
A representative output
This compact example is selected because the visible result clearly demonstrates ^BX.
Recommended rendered sample
Uses ^BX in a compact label where its visible effect is easy to inspect.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^XZoOrientation
Sets orientation. It can be omitted when the documented default is suitable.
- Default
current ^FW value- Required
- No
NRIBo variations
Compare values side by side; other parameters remain at representative defaults.
o = N
Uses N for orientation while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZo = R
Uses R for orientation while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXR,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZo = B
Uses B for orientation while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXB,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZhDimensional height of individual symbol elements
Sets dimensional height of individual symbol elements. It can be omitted when the documented default is suitable.
- Required
- No
0h variations
Compare values side by side; other parameters remain at representative defaults.
h = 0
Uses 0 for dimensional height of individual symbol elements while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,0,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZh = 1
Uses 1 for dimensional height of individual symbol elements while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,1,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZsQuality level
Sets quality level. It can be omitted when the documented default is suitable.
- Default
0 Quality refers to the amount of data that is added to the symbol for error correction- Required
- No
05080100140200s variations
Compare values side by side; other parameters remain at representative defaults.
s = 0
Uses 0 for quality level while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,0,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZs = 50
Uses 50 for quality level while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,50,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZs = 200
Uses 200 for quality level while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZcColumns to encode
Sets columns to encode. It can be omitted when the documented default is suitable.
- Range
9–49- Required
- No
0949c variations
Compare values side by side; other parameters remain at representative defaults.
c = 0
Uses 0 for columns to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZc = 9
Uses 9 for columns to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,9,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZc = 49
Uses 49 for columns to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,49,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZrRows to encode
Sets rows to encode. It can be omitted when the documented default is suitable.
- Range
9–49- Required
- No
0949r variations
Compare values side by side; other parameters remain at representative defaults.
r = 0
Uses 0 for rows to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZr = 9
Uses 9 for rows to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,9,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZr = 49
Uses 49 for rows to encode while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,49,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZfFormat ID (0 to 6) — not used with quality set at 200
Sets format ID (0 to 6) — not used with quality set at 200. It can be omitted when the documented default is suitable.
- Default
6- Required
- No
612345f variations
Compare values side by side; other parameters remain at representative defaults.
f = 1
Uses 1 for format ID (0 to 6) — not used with quality set at 200 while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,1,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZf = 2
Uses 2 for format ID (0 to 6) — not used with quality set at 200 while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,2,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZf = 6
Uses 6 for format ID (0 to 6) — not used with quality set at 200 while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZgEscape sequence control character
Sets escape sequence control character. It can be omitted when the documented default is suitable.
- Default
~ (tilde) This parameter is used only if quality 200 is specified- Required
- No
_g variations
Compare values side by side; other parameters remain at representative defaults.
g = _
Uses _ for escape sequence control character while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZg = #
Uses # for escape sequence control character while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,#,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZaAspect ratio
Sets aspect ratio. It can be omitted when the documented default is suitable.
- Default
1- Required
- No
12a variations
Compare values side by side; other parameters remain at representative defaults.
a = 1
Uses 1 for aspect ratio while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,1
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZa = 2
Uses 2 for aspect ratio while the other command values stay at representative defaults.
^XA
^PW640
^LL360
^FO36,32
^BY2,2,90
^BXN,5,200,0,0,6,_,2
^FDZPLR-DATAMATRIX^FS
^FO28,318^A0N,22,22^FDCaret BX parameter example^FS
^XZPrimary source
Official Zebra reference
Use the manufacturer reference for printer- and firmware-specific behavior beyond ZPLr’s pinned rendering profile.