# 82label

> Design label templates on 82label.app and print them from your own site. Roll labels for thermal label printers (any size), 52 Formtec A4 sheet layouts, courier waybill templates for Korean couriers (CJ Logistics, Hanjin, Lotte, Korea Post, Logen and more; subscribers), barcodes (Code 128, EAN-13, EAN-8, UPC-A, Code 39, ITF, ITF-14) and QR codes, {{field}} placeholders filled from data rows. Browser printing is mm-accurate (@page size, no margins); with the 82label Windows print agent, labels print silently with no dialog. Zero-dependency TypeScript library @82label/core (global Label82, <label-82> web component), MIT. Made by 2nd Korea (세컨드코리아).

Current version: 0.2.0 (2026-10-22). Library license: MIT, free for commercial use.
Install: npm i @82label/core
CDN: https://82label.app/cdn/v0.2.0/82label.min.js (global Label82, registers <label-82>), https://82label.app/cdn/v0.2.0/82label.esm.js, https://82label.app/cdn/v0.2.0/82label.css
Usage: Label82.print(template, rows, { mode: 'auto' | 'agent' | 'browser', printer, copies, startAt }) where template is a JSON object { v: 1, name, paper: { kind: 'roll', dpi } | { kind: 'sheet', cols, rows, marginTop, marginLeft, pitchX, pitchY }, label: { width, height }, elements: [{ type: 'text' | 'barcode' | 'qr' | 'image' | 'line' | 'rect', … }] } in millimetres, or a saved template id ('lbl_…') loaded from https://82label.app/api/t/<id>. renderToSVG(template, row) draws without a DOM. barcodeSVG(value, { format }) and qrSVG(value) draw codes on their own.
Result: { via: 'agent' | 'browser', printed, status: 'done' | 'pending_permission' | 'cancelled', errors, notice? }. The print agent listens on http://127.0.0.1:18282 and asks the user before a new site may print.
Pricing: the designer, JSON export, the library, browser printing and roll/Formtec templates are free. Templates saved on 82label: 3 free, then 5000 KRW per template per month (VAT included); subscribers also get courier waybill templates and the Windows print agent. Toss Payments monthly billing, cancel any time. Everything is free until the official launch.
Template JSON Schema: https://82label.app/schema/template.json
Korean docs: https://82label.app/docs/ · English docs: https://82label.app/en/docs/
All docs as one Markdown file: https://82label.app/llms-full.txt · Any docs page as Markdown: add .md, e.g. https://82label.app/en/docs/barcodes.md

## Start

- [Getting started](https://82label.app/en/docs/getting-started.md): Make a template and print your first label from your site.
- [CDN](https://82label.app/en/docs/cdn.md): Script tags: pinned URLs, the files, and the global Label82.
- [npm](https://82label.app/en/docs/npm.md): Installing @82label/core, imports, bundlers and TypeScript.

## Templates

- [Template JSON](https://82label.app/en/docs/template.md): Paper, label size and the element list. Every length is in millimetres.
- [Fields ({{ }})](https://82label.app/en/docs/fields.md): Write changing values as {{name}}; each data row prints one label.
- [Value formats, serial numbers, dates](https://82label.app/en/docs/formats.md): {{price|won}}, {{date|date:YYYY.MM.DD}}, {{seq:0001}}, {{today+365}}: change how values print without touching the data.

## Paper

- [Roll labels](https://82label.app/en/docs/roll.md): Thermal label printer rolls: size, dpi and direction.
- [Formtec sheets](https://82label.app/en/docs/sheets.md): 52 Formtec A4 sheet labels: grid, size, margins and the start slot (startAt).
- [Courier waybills](https://82label.app/en/docs/couriers.md): Courier waybill templates (subscribers) with tracking number and sort code fields.

## Barcodes and QR

- [Barcodes](https://82label.app/en/docs/barcodes.md): Code128, EAN-13 and 8, UPC-A, Code39, ITF, ITF-14: check digits and scannable sizes.
- [QR codes](https://82label.app/en/docs/qr.md): The QR element, error correction levels, size and length.

## Printing

- [Printing (browser, agent, silent)](https://82label.app/en/docs/printing.md): The three modes of print(), the result, picking a printer, and browser dialog settings.
- [Print agent: install and link](https://82label.app/en/docs/agent.md): Install the Windows print agent, link it with an account key, allowed sites, auto update.
- [Bulk printing from Excel](https://82label.app/en/docs/bulk.md): No code: upload Excel or CSV, match columns, print one label per row. Copies column, start slot, PDF.
- [Print calibration](https://82label.app/en/docs/calibration.md): Measure a printer's offset and scale once; it applies to every print after that.
- [Save as PDF](https://82label.app/en/docs/pdf.md): A PDF at the exact size in mm; barcodes, QR codes and lines are vectors.

## Web component and frameworks

- [Web component <label-82>](https://82label.app/en/docs/element.md): A preview and a print button from one tag: attributes, properties, events.
- [React and Vue](https://82label.app/en/docs/frameworks.md): Using @82label/core from React and Vue.

## Reference

- [API reference](https://82label.app/en/docs/api.md): Every function and value exported by @82label/core (the global Label82).

## Pricing and FAQ

- [Saved templates and pricing](https://82label.app/en/docs/pricing.md): Free when you host the template yourself; 3 saved templates free, then ₩5,000 per template per month.
- [FAQ](https://82label.app/en/docs/faq.md): Pricing, printers, sheet alignment, the print agent, security.

## 한국어 문서 (Korean docs)

82label 은 82label.app 에서 라벨 서식을 디자인하고 내 사이트에서 Label82.print() 한 줄로 인쇄하는 도구입니다. 롤 라벨, 폼텍 A4 시트, 택배 송장(구독자), 바코드·QR. 브라우저 인쇄는 mm 단위로 정확하고, Windows 출력 프로그램이 있으면 인쇄 창 없이 바로 나갑니다.

- [시작하기](https://82label.app/docs/getting-started.md): 서식을 만들고 내 사이트에서 첫 라벨을 인쇄합니다.
- [CDN](https://82label.app/docs/cdn.md): 스크립트 태그로 붙이기: 버전 고정 주소, 파일 종류, 전역 Label82.
- [npm](https://82label.app/docs/npm.md): @82label/core 설치, import, 번들러와 TypeScript.
- [서식 JSON](https://82label.app/docs/template.md): 용지, 라벨 크기, 요소 목록. 모든 길이는 mm 입니다.
- [필드 ({{ }})](https://82label.app/docs/fields.md): 바뀌는 값을 {{이름}} 으로 적고, 데이터 한 줄이 라벨 한 장이 됩니다.
- [값 서식·일련번호·날짜](https://82label.app/docs/formats.md): {{가격|won}}, {{날짜|date:YYYY.MM.DD}}, {{seq:0001}}, {{today+365}}. 데이터를 고치지 않고 찍히는 모양만 바꿉니다.
- [롤 라벨](https://82label.app/docs/roll.md): 감열 라벨프린터의 롤 용지: 크기, dpi, 방향.
- [폼텍 시트](https://82label.app/docs/sheets.md): A4 시트 라벨 52종의 칸 수·크기·여백과 시작 칸(startAt).
- [택배 송장](https://82label.app/docs/couriers.md): 택배사별 송장 기본서식(구독자 전용)과 송장번호·분류코드 필드.
- [바코드](https://82label.app/docs/barcodes.md): Code128, EAN-13·8, UPC-A, Code39, ITF, ITF-14. 체크 숫자와 스캔 크기.
- [QR 코드](https://82label.app/docs/qr.md): QR 요소, 오류 정정 단계, 크기와 길이.
- [인쇄 (브라우저·출력 프로그램·사일런트)](https://82label.app/docs/printing.md): print() 의 세 가지 방식, 결과 값, 프린터 고르기, 브라우저 인쇄 창 설정.
- [출력 프로그램 설치·연결](https://82label.app/docs/agent.md): Windows 출력 프로그램 설치, 계정 키 연결, 허용 사이트, 자동 업데이트.
- [엑셀로 대량 출력](https://82label.app/docs/bulk.md): 코드 없이 엑셀·CSV 를 올리고 칸을 맞춰 행마다 라벨을 찍습니다. 수량 열, 시작 칸, PDF 저장.
- [인쇄 보정](https://82label.app/docs/calibration.md): 프린터마다 몇 mm 씩 밀리는 위치와 배율을 한 번 재서 저장하면 인쇄할 때마다 적용됩니다.
- [PDF 저장](https://82label.app/docs/pdf.md): mm 크기 그대로의 PDF. 바코드·QR·선은 벡터라 확대해도 선명합니다.
- [웹 컴포넌트 <label-82>](https://82label.app/docs/element.md): 태그 하나로 미리보기와 인쇄 버튼. 속성, 프로퍼티, 이벤트.
- [React · Vue](https://82label.app/docs/frameworks.md): @82label/core 를 React·Vue 에서 쓰는 예제.
- [API 레퍼런스](https://82label.app/docs/api.md): @82label/core(전역 Label82)가 내보내는 모든 함수와 값.
- [서버 보관과 요금](https://82label.app/docs/pricing.md): 직접 쓰면 무료, 82label 에 보관하는 서식은 3개까지 무료, 그 뒤로 서식당 월 5,000원.
- [자주 묻는 질문](https://82label.app/docs/faq.md): 요금, 프린터, 폼텍 칸 밀림, 출력 프로그램, 보안.

## Other

- [Designer](https://82label.app/en/designer/)
- [Templates: roll sizes, 52 Formtec sheets, 10 courier waybills](https://82label.app/en/templates/)
- [Pricing](https://82label.app/en/pricing/)
- [Windows print agent download](https://82label.app/en/download/)
- [Changelog](https://82label.app/en/changelog/)
- [Forum](https://82label.app/en/forum/)