Barcode Syntax

It's easy to add barcodes to your documents with TemplateDocs. The barcode tag syntax is the same as a simple text tag:

Provide the barcode details in your JSON data using the barcode object structure shown below:

{
  "MyBarcode": {
    "_type": "barcode",
    "data": "123456789012"
  }
}

This will create a barcode that encodes "123456789012" with default settings (CODE128 format, black on white, auto-sized).

Using Image Placeholders

Barcodes can also be inserted using image placeholders. This allows you to replace existing images in your template with generated barcodes. To mark an image as a placeholder, insert a tag in its alt text. Then use the same JSON data as you would for a regular barcode tag. For example:

{
  "MyPlaceholder": {
    "_type": "barcode",
    "data": "123456789012"
  }
}

Barcode Properties

Examples

Simple Barcode

{
  "ProductCode": {
    "_type": "barcode",
    "data": "123456789012"
  }
}

This creates a barcode with default settings (CODE128 format, black on white, auto-sized).

Custom Styled Barcode

{
  "CustomBarcode": {
    "_type": "barcode",
    "data": "123456789012",
    "format": "EAN13",
    "color": "#2563eb",
    "background": "#e2e8f0",
    "barWidth": 3,
    "barHeight": 120,
    "margin": 15,
    "showText": true,
    "fontSize": 16,
    "textDistance": 15
  }
}

This creates a blue barcode on a light gray background with custom bar dimensions and styling.

Supported Barcode Formats