ZPLコマンドリファレンス — Zebraプリンターのチートシート

2026年6月11日 更新

これは実際のラベルの大多数をカバーするZPL IIコマンドの実用リファレンスです：フォーマット構造・テキスト・フォント・バーコード・グラフィック・プリンター制御。すべての位置とサイズは プリンタードット で表します（203 dpi = 8ドット/mm — 詳細は ZPLとは？ を参照）。構文列のパラメーターは：x,y = 左上角からの位置、 h,w = 高さと幅、o = 向き（N 正立、R 90°、I 180°、B 270°）。

ラベルフォーマット

コマンド構文機能
^XA^XAラベルフォーマットの開始。すべてのラベルはこのコマンドで始まります。
^XZ^XZラベルフォーマットの終了。プリンターはこのコマンドを受け取るとラベルをレンダリングして印刷します。
^FX^FXcommentコメント — プリンターに無視されます。他のフィールドと同様に ^FS で終了します。
^PW^PWwidth印刷幅（ドット）。フィールドが切り取られないよう、ラベルの幅に設定してください。
^LL^LLlengthラベル長（ドット）。主に連続媒体（ギャップなし）に必要です。
^LH^LHx,yラベルホーム — 以降のすべての ^FO 位置の原点をシフトします。
^PQ^PQqty印刷枚数 — このラベルを何枚印刷するか。
^PR^PRspeed印刷速度（インチ/秒）。低速の方が濃く鮮明に印刷されることが多いです。
^MD^MDdarkness媒体の暗さ調整（-30〜30）。印刷が薄い場合は値を上げてください。

フィールドとテキスト

コマンド構文機能
^FO^FOx,yフィールド原点 — 次のフィールドをラベルホームから x,y ドットの位置に配置します。
^FD^FDdataフィールドデータ — 現在のフィールドのコンテンツ（テキストまたはバーコードデータ）。
^FS^FSフィールドセパレーター — 現在のフィールドを閉じます。各フィールドの後に必要です。
^FB^FBwidth,lines,space,alignフィールドブロック — ^FD テキストをブロックに折り返します：最大幅・最大行数・行間隔・配置（L/C/R/J）。
^FR^FRフィールド反転 — 黒い領域と重なる部分に白黒反転でフィールドを印刷します。
^FH^FHフィールド16進数 — ^FD 内での _xx 16進エスケープを許可します（例：é には _C3_A9）。
^CI^CIencoding文字セット。^CI28 は UTF-8 を選択します。ASCII以外のテキストには推奨です。

フォント

コマンド構文機能
^A^Afo,h,w次のフィールドのフォント：フォント文字 f（0〜9、A〜Z）・向き・高さ・幅（ドット）。^A0N,40,40 はデフォルトのスケーラブルフォント（40ドット）です。
^CF^CFf,h,w^A を設定しない後続のすべてのフィールドのデフォルトフォントを変更します。
^A@^A@o,h,w,nameプリンターに保存されているフォントファイル（例：ダウンロードしたTrueType）を使用します。

フォント 0 はスケーラブルベクターフォントで通常の選択肢です。フォント A–H は固定サイズのビットマップフォントで、ネイティブサイズまたはその整数倍でのみ見栄えが良くなります。

バーコード

コマンド構文機能
^BY^BYw,r,hバーコードフィールドのデフォルト：モジュール（細バー）幅（ドット）・広狭比・デフォルト高さ。バーコードコマンドの前に設定します。
^BC^BCo,h,f,g,e,mCode 128 — 配送・物流の主力1Dバーコード。f=Y で人間が読める行を印刷、g=Y でコードの上に印刷。
^B3^B3o,e,h,f,gCode 39 — 一部の産業・防衛規格で依然要求される古い1Dシンボル。
^BE^BEo,h,f,gEAN-13 小売バーコード（UPC-Aには ^BU を使用）。
^BQ^BQa,model,mag,ecQRコード。倍率1〜10でモジュールサイズを設定、ec で誤り訂正レベルを設定（H/Q/M/L）。データの前にエンコードモードを付けます（例：^FDQA,https://…）。
^BX^BXo,h,s,c,r,fData Matrix — 電子機器・医療ラベルによく使われるコンパクトな2Dコード。
^B7^B7o,h,m,c,r,tPDF417 — IDや一部の物流書類に使われるスタック型2Dコード。

スキャン可能なバーコードのために、3つの点を確認してください：203 dpi で ^BY（最初のパラメーター）を最低2〜3ドット以上、両側に約10モジュール幅の余白スペース、そして十分な高さ（1Dバーコードが約50ドット未満だとハンディスキャナーで読みにくくなります）。

グラフィック

コマンド構文機能
^GB^GBw,h,t,c,rグラフィックボックス：幅・高さ・枠の太さ・色（B/W）・角の丸み0〜8。細い ^GB でラインを描画します。
^GC^GCd,t,c直径 d・枠の太さ t のグラフィック円。
^GD^GDw,h,t,c,ow×h ボックス内の斜線：o で向き（L または R）を設定。
^GF^GFa,b,c,d,dataグラフィックフィールド — ビットマップ（例：ロゴ）を16進またはバイナリデータとしてラベルに直接埋め込みます。
~DG~DGd:name,t,w,dataグラフィックのダウンロード — プリンターに画像を保存し、^XG で配置します。
^XG^XGd:name,mx,my保存されているグラフィックを現在のフィールド原点に x/y 倍率で呼び出します。

プリンター制御とステータス

コマンド構文機能
~HS~HSホストステータス — プリンターが用紙切れ・一時停止・バッファ・オドメーター情報を返します。
~HI~HIホスト識別情報 — モデル・ファームウェアバージョン・DPI・メモリ。
^MM^MMmode印刷モード：T ティアオフ、P ピールオフ、R リワインド、C カッター。
^MN^MNtype媒体追跡：Y ギャップ/ウェブ感知、M ブラックマーク、N 連続。
~JC~JC媒体キャリブレーションを実行（プリンターが数枚送ってギャップを検出します）。
~JA~JAプリンターバッファ内のすべてのラベルフォーマットをキャンセルします。
^JUS^JUS現在の設定をフラッシュに保存し、電源サイクル後も維持します。

まとめ：実際のラベル例

上記のグループのほとんどを使用した典型的な 4×6 配送スタイルのラベル：

^XA
^PW812
^CI28
^CF0,32

^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS

^FO40,230^GB732,3,3^FS

^FO40,260^FDOrder #A-10592 / 3 of 4^FS

^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZ

ドット座標を手動で編集するのはすぐに大変になります — レイアウトを少し変えるたびに数値を変更して再印刷が必要です。フィールドをドラッグ＆ドロップで配置してZPLを自動生成したい場合は、下のZPLCraftエディターがビジュアルキャンバスをまさにこのようなクリーンなZPLにコンパイルし、 ブラウザからUSBで印刷することもできます。

このチートシートを超えた詳細なパラメーターごとの説明については、権威ある公式リソースとしてZebraの ZPL IIプログラミングガイド があり、ZebraのサポートサイトからPDFで無料ダウンロードできます。