DocumentationDocumentation
Darty.ai
Get Started
Basics
Methods
Colors
UI
Workflows
Darty.ai
Get Started
Basics
Methods
Colors
UI
Workflows
  • Get Started

    • Installation and Login
    • Your First Darty Document
    • Installers - Instructions and Downloads
    • Licensing
  • Basics

    • Darty Basics
    • Darty Header
    • Darty Tags
  • Methods

    • Darty-Ai Methods
    • Align
    • Appearance - General
    • Appearance - Colors & Swatches
    • Appearance - Effect Properties
    • Artboard Methods
    • Arrange
    • Attributes
    • Barcode
    • Barcode Formats
    • Clean Document
    • Clipping Mask Make and Release
    • Color Mode
    • Comment
    • Compound Path - Make and Release
    • Distribute
    • Duplicate
    • Expand
    • Fit To Bounds
    • Graphic Style
    • Group & Ungroup
    • Layer Methods
    • Outline
    • Pathfinder
    • Place
    • Rasterize
    • Reduce To Basic Appearance
    • Remove
    • Swatch Methods
    • Tags Methods
    • Tables
    • Template
    • Text
    • Transform Methods
    • zOrder
    • Skip and *
  • Colors

    • Color Libraries
  • Sheet Builder
    • Builder Table Anatomy
    • Builder Data Sources and Files
    • Builder Method Blocks
    • Builder Rows, Cells, and Navigation
  • User Interface

    • Darty-Ai User Interface
    • Tools Tab
    • Compress Images
    • Tools Methods
      • Tools Method Actions and Apply Modes
      • Tools Method Table Preview
      • Align Tool
      • Appearance Tool
      • Graphic Style Tool
      • Artboard Tool
      • Attributes Tool
      • Arrange Tool
      • Barcode Tool
      • Color Mode Tool
      • Clean Tool
      • Clipping Tool
      • Comment Tool
      • Compound Path Tool
      • Distribute Tool
      • Duplicate Tool
      • Expand Tool
      • Fit to Bounds Tool
      • Group Tool
      • Ungroup Tool
      • Layer Tool
      • Outline Tool
      • Pathfinder Tool
      • Place Tool
      • Rasterize Tool
      • Reduce Tool
      • Remove Tool
      • Swatches Tool
      • Tags Tool
      • Table Tool
      • Skip Row Tool
      • Template in Sheet Builder
      • Text Tool
      • Transform Tool
      • Z-Order Tool
    • Tags Panel
    • Tables Panel
    • Annotations and Canvas Controls
    • Tags Tab
    • Data Tab
    • Export Tab
    • Settings Tab
    • Help Tab
    • Export Settings
    • Export Validation
    • Job Export Settings
    • Export Counter Variables
    • Export Progress
    • Export Presets
    • Recent Files
    • Color Dialog
  • Cloud Data

    • Darty-Ai Cloud Data Integrations
    • Darty-Ai with Google Sheets
  • Workflows

    • Darty-Ai Workflows
    • Darty Preview
    • Darty Export Workflows
    • Darty Data Workflows
    • Utilities
      • Compression
      • XMP Usage
  • Site Blog

    • ⭐️What’s new in Darty-Ai 2.5 ⭐️
    • ⭐️Getting Started ⭐️
    • ⭐️Placing Images in Darty-Ai ⭐️
    • 🚀 New Features — Darty-Ai 1.7.8 (March 2026)
    • Creating a Basic Pie-Chart with Line-Art & Data
    • Customer Data and Darty-Ai
    • Darty-Ai Now Supports Google Sheets
    • External SVGs with Darty-Ai
    • Preview Your Documents
    • Self-Adjusting Logo Automation
    • State Management for Artwork Appearance
    • Text Replacements and Formatting
    • Using Private Google Sheets Shared with Business Emails
  • Site Pages

    • 🏠 Home
    • 💰 Pricing
    • Downloads
    • Legal
  • Release Notes
  • Downloads

Barcode

The barcode method creates editable vector barcodes in Illustrator. It supports QR and matrix codes, retail and logistics symbols, linear formats, GS1 encoding, placement into tagged artwork, color and text styling, and names or tags for generated parts.

Use the Barcode editor in Tools → Methods to choose a format, validate sample data, preview the result, and add the method block to Builder. See the Barcode editor guide for the editor workflow.

A managed stock table and vector QR code generated in Illustrator

Download the editable Illustrator example. The illustration was generated with the native plug-in; the sheet examples below show how to author records.

Method editor

Barcode controls

Barcode editor, upper section

Barcode editor, lower section

How Barcode Placement Works

A barcode can be created in either of two ways:

  • Leave the method block's Darty header blank to create the barcode at x and y, then use scale, rotation, or manual sizing properties as needed.
  • Put a tag search in the Darty header to use matching artwork as the placement target. The target is replaced by default; set replace to false to preserve it.

tagSearch is also accepted as a property when authoring a sheet manually. In Builder, the tag search is normally represented by the first header row above the barcode method.

Supported Formats

Choose a format that is valid for the supplied data. Format-specific options are ignored or rejected when they do not apply to the chosen symbology.

See Barcode Formats for plain-language descriptions, format families, and guidance on choosing among these formats.

FormatFormatFormatFormat
AztecAztec CodeAztec RuneCodabar
Code 32Code 39Code 39 ExtendedCode 39 Standard
Code 93Code 128Compact PDF417Data Matrix
DataBarDataBar ExpandedDataBar Expanded StackedDataBar Limited
DataBar OmniDataBar StackedDataBar Stacked OmniDX Film Edge
EAN-2EAN-5EAN-8EAN-13
EAN/UPCGS1 Digital Link QRISBNITF
ITF-14MaxiCodeMicro QR CodeMicroPDF417
PDF417PharmazentralnummerQR CoderMQR Code
rMQRUPC-AUPC-E

The editor labels this format GS1 Digital Link QR and writes GS Digital Link QR Code in the sheet.

Core Encoding Properties

PropertyDescription
format 
Barcode symbology. Examples: QR Code, Code 128, EAN-13, Data Matrix, PDF417, GS Digital Link QR Code.
data 
Text or numeric content to encode. The value must satisfy the selected format's rules. Digital Link can use its dedicated fields instead.
variant 
Optional variant supported by the selected generator.
ecLevel 
Error-correction level for QR Code, Micro QR Code, and rMQR. Valid Values: L, M, Q, H.
creatorOptionsGs1 
Enables GS1 mode where supported. Valid Values: true, false.
bytes 
Numeric byte array to encode instead of a text value in supported formats.
squareData 
/
squareFinder 
Controls square data/finder modules for supporting matrix formats. Configure only when the editor exposes these options for the selected format.
invert 
Inverts the generated symbol. Valid Values: true, false.
addHRT 
Controls human-readable text. Valid Values: true, false; omit it to use the format default.
skip 
Skips the method for this data row. See * and Skip. Valid Values: true, false.

The four QR error-correction levels recover approximately 7%, 15%, 25%, and 30% of damaged codewords respectively. Higher correction makes the symbol denser, so use only as much as the production environment requires.

GS1 Mode

The standard Tools control exposes GS1 mode for Code 128, QR Code, and Data Matrix:

  • Code 128 adds the FNC1 control character.
  • QR Code uses the GS1 first-position indicator.
  • Data Matrix support does not currently guarantee complete GS1 specification compliance; validate the result with the scanner and workflow that will consume it.

GS1 Digital Link QR

Digital Link can be assembled from GS1 fields or supplied as a complete URI.

PropertyDescription
gtin 
Required GTIN. Use 13 or 14 digits in the editor. A 13-digit value receives a calculated check digit; a 14-digit value must already have a valid check digit.
batch 
Optional batch or lot value, encoded as GS1 AI 10.
serial 
Optional serial number, encoded as GS1 AI 21.
expiryDate 
Optional expiration date, encoded as AI 17. Use YYYY-MM-DD in the Tools editor.
bestBeforeDate 
Optional best-before date, encoded as AI 15. Use YYYY-MM-DD in the Tools editor.
productionDate 
Optional production date, encoded as AI 11. Use YYYY-MM-DD in the Tools editor.
resolverDomain 
Resolver origin. Default Value: https://id.gs1.org.
useRawUri 
Uses rawUri instead of assembling the link from GS1 fields. Valid Values: true, false.
rawUri 
Complete Digital Link URI used with useRawUri. If the scheme is omitted, Darty adds https://; the final value must be a valid URL.

Batch and serial identifiers are written as path segments. Date identifiers are written as Digital Link query parameters using GS1's YYMMDD representation.

Placement and Sizing

PropertyDescription
tagSearch 
Finds target artwork for barcode placement. Builder normally writes this in the Darty header.
replace 
Replaces tagged target artwork. Default Value: true; use false to keep the target.
fitToTargetBounds 
Fits the barcode to the bounds of tagged target artwork. Valid Values: true, false.
scale 
Scale used when the barcode is created without a tagged target.
moduleSize 
Size of one matrix module.
barWidth 
Base bar width for supported linear formats.
xDimension 
X-dimension for formats that define sizing with it.
width 
Requested overall width.
height 
Requested overall height.
size 
Requested square size for supported matrix formats.
barHeight 
Bar height for supported linear formats.
unit 
Unit for placement and sizing values. Valid Values: pt, mm, cm, in.
quietZoneModules 
Quiet zone on all sides, measured in modules.
quietZoneXModules 
Horizontal quiet zone, measured in modules.
quietZoneYModules 
Vertical quiet zone, measured in modules.
padding 
Physical clear space around the symbol in the chosen unit. When supplied, takes precedence over separate X/Y padding.
paddingX 
/
paddingY 
Separate horizontal/vertical padding when uniform padding is unset.
anchorPoint 
Reference point for positioning, such as topLeft or center.
rulerSystem 
global or artboard for untagged X/Y placement.
rulerArtboardName 
/
rulerArtboardNumber 
Coordinate-base artboard for untagged placement; number is one-based.
autoRotate 
Allows Darty to rotate the symbol to better fit its target. Valid Values: true, false.
rotationDegrees 
Rotation in degrees.
x 
Horizontal document position when no tagged target is supplied.
y 
Vertical document position when no tagged target is supplied.

Builder now writes the configured sizing, padding, quiet-zone, anchor, and ruler fields into the method block. Use the generated columns as the starting point for a spreadsheet.

Colors and Overprint

Barcode modules and the optional background are independent colors. Each can use a general color value, swatch, or explicit color-model channels.

PropertyDescription
moduleColor 
General module or foreground color.
moduleColorModel 
Module color model. Valid Values: none, swatch, color, cmyk, rgb, gray, lab, hsb, hsv, hsl.
moduleColorName 
Swatch name when moduleColorModel is swatch.
moduleColorR / G / B 
RGB channels.
moduleColorC / M / Y / K 
CMYK channels.
moduleColorGray 
Gray channel.
moduleColorL / A / B 
Lab channels.
moduleColorH / S / V 
HSB, HSV, or HSL channels according to moduleColorModel.
backgroundColor 
General background color.
backgroundColorModel 
Background model; accepts the same models as moduleColorModel.
backgroundColorName 
Background swatch name.
backgroundColorR / G / B 
RGB background channels. Equivalent CMYK, Gray, Lab, HSB, HSV, and HSL channel properties are also accepted.
overprint 
Applies overprint to supported generated artwork. Valid Values: true, false.

Use adequate contrast and preserve the quiet zone. Always test final artwork after color conversion, scaling, rasterization, or printing; a valid vector preview does not guarantee that every production scanner can read the result.

Human-Readable Text

Linear barcode formats can include human-readable text below the symbol.

PropertyDescription
addHRT 
true forces text, false removes it, and an omitted value uses the symbology default.
fontSize 
Text size.
textUnit 
Unit for fontSize. Valid Values: pt, mm, cm, in.
font 
Font or PostScript name.
gap 
Space between the symbol and text.
gapUnit 
Unit for gap.
fitBarcodeWidth 
Fits the text across the barcode width. Valid Values: true, false.
tracking 
Character tracking.
horizontalScale 
Horizontal text scale.

Naming and Tagging Generated Parts

Darty can assign Illustrator names and tags to the complete symbol and to format-specific parts. Finder and data parts are primarily useful for matrix formats, while the text part is relevant only when human-readable text exists.

PartName propertyTags property
Complete symbol
symbolName 
symbolTags 
Human-readable text
textName 
textTags 
Finder patterns
finderName 
finderTags 
Data marks
dataName 
dataTags 
Background
backgroundName 
backgroundTags 

Tag values may be supplied as arrays or list-style spreadsheet values according to the normal Darty array syntax.

Advanced Format Options

The following accepted properties are format-specific and are most often added manually. A generator may ignore or reject a property that does not belong to its format.

PropertyDescription
eci 
Extended Channel Interpretation assignment.
readerInit 
Reader-initialization mode where supported.
forceSquare 
Forces a square form for a supporting matrix format.
columns 
and
rows 
Requested dimensions for stacked formats such as PDF417 variants.
version 
Explicit symbol version for supporting QR-family formats.
dataMask 
Explicit data mask where supported.
guardDescent 
Guard-bar descent for supporting retail formats.
compliantHeight 
Uses the generator's compliant-height behavior. Valid Values: true, false.
heightPerRow 
Row height for a supporting stacked format.
creatorOptions 
Advanced generator options object for programmatic use.
dryRun 
Runs supported barcode processing without committing normal artwork output. Valid Values: true, false.

Many advanced properties also accept a creatorOptions prefix, such as creatorOptionsEci, creatorOptionsColumns, and creatorOptionsVersion.

Sample Spreadsheets

QR Code at a Document Position

*
barcode
formatdataecLevelscalexymoduleColorModelmoduleColorRmoduleColorGmoduleColorB
FormatContentCorrectionScaleXYColor modelRedGreenBlue
QR Codehttps://darty.aiM472pt72ptrgb303030

Code 128 in Tagged Artwork

The first matching object tagged product-code is the placement target. replace: false preserves that object.

product-code
barcode
formatdatacreatorOptionsGs1addHRTreplacesymbolName
FormatContentGS1Show textKeep targetIllustrator name
Code 1280109501101530003truetruefalseProduct Barcode

GS1 Digital Link QR

package-qr
barcode
formatgtinbatchserialexpiryDateresolverDomainecLevel
FormatGTINBatchSerialExpirationResolverCorrection
GS Digital Link QR Code09501101530003LOT-204SN-18322027-12-31https://id.gs1.orgH

Raw Digital Link URI

*
barcode
formatuseRawUrirawUriquietZoneModules
FormatUse complete URIURIQuiet zone
GS Digital Link QR Codetruehttps://id.gs1.org/01/09501101530003/21/SN-18324

Validation and Troubleshooting

  • Confirm that the data is valid for the selected symbology. Retail formats require specific lengths and check digits.
  • For Digital Link, verify the GTIN check digit and use a valid resolver or raw URL.
  • Do not crop the quiet zone or stretch a symbol non-proportionally after generation.
  • Use addHRT: false if text is not appropriate for the selected format; not every symbol supports human-readable text.
  • Format-specific properties should only be supplied to formats that support them.
  • Test the final exported or printed result with the intended scanners and production conditions.

Related Documentation

  • Barcode formats
  • Barcode editor
  • Builder method blocks
  • Barcode Tool
  • * and Skip

Example: a product link per record

Tag a rectangular placeholder product-link in Illustrator. The barcode replaces it on each preview. Keep URLs as text in the data sheet.

product-link
barcode
format:QR Codedata
Product URL
https://example.com/products/notebook
https://example.com/products/pencil

Download the product-link CSV. Open it in Builder or Data and preview each record against the tagged template. Use the same pattern for Code 128 with suitable identifier text. Preserve leading zeros by formatting identifier columns as text in your spreadsheet application.

Before production, scan the final-size output and check the decoded value. The editor preview confirms generation; it does not certify printed output.

Last Updated: 11/11/26, 5:07 PM
Contributors: Vasily Hall, Trevor
Prev
Attributes
Next
Barcode Formats