EAN - lindell/JsBarcode GitHub Wiki

About EAN

EAN comes in a variety of forms, most commonly used is EAN-13 (GTIN-13) that is used on world wide to marking the identity of products.

JsBarcode supports the formats EAN-13, EAN-8 and UPC as well as the barcode addons EAN-5 and EAN-2.

Supported modes

JsBarcode("#barcode", "5901234123457", {format: "EAN13"});
JsBarcode("#barcode", "123456789999", {format: "UPC"});
JsBarcode("#barcode", "96385074", {format: "EAN8"});
JsBarcode("#barcode", "54495", {format: "EAN5"});
JsBarcode("#barcode", "53", {format: "EAN2"});

Addon EAN-5 / EAN-2

EAN-5 and EAN-2 is addon barcodes an is always used combined with EAN-13 or EAN-8. The advanced JsBarcode syntax can be used to add these addons to the barcodes.

JsBarcode("#barcode")
  .EAN13("1234567890128")
  .blank(20)  // An blank creates a space between the barcodes
  .EAN5("12345", {height: 85, textPosition: "top", fontSize: 16})
  .render();

flat options for EAN-13, EAN-8 and UPC

EAN-13, EAN-8 and UPC barcodes is most often used with "guard bars". If you don't want these and instead a flat rendering you can specify the flat option and skip the guard bars.

JsBarcode("#barcode", "1234567890128", {
  format: "ean13",
  flat: true
});

lastChar options for EAN-13

EAN-13 is sometimes printed with with a character after the barcode, most common is the > character. This is supported in JsBarcode with the lastChar option.

JsBarcode("#barcode", "1234567890128", {
  format: "ean13",
  lastChar: ">"
});

OCR-B font

When creating an EAN or UPC barcode it is standard to use the OCR-B font. Most variants of this font is not free. There are free versions but none that (we have found) that have the correct license to be able to include in the JsBarcode repository.

When using a custom font with JsBarcode you can specify the font with @font-face and then do the JsBarcode call. Note that the font has to be loaded before the generation can be made correctly.

JsBarcode("#canvasBarcode", "123456789012", {
  format: "EAN13",
  font: "OCRB",
  fontSize: 18,
  textMargin: 0
});

Check digits

EAN-13, UPC and EAN-8 all have the last digit being a check digit to verify the content that is encoded. This digit is considered a part of the number and JsBarcode will verify it before generating the barcode.

If the last digit of these barcodes are not specified it will automatically be calculated and added.

JsBarcode("#barcode", "96385074", {format: "EAN8"});
// These two are generating identical barcodes
JsBarcode("#barcode", "9638507", {format: "EAN8"});