← All documentation

CSV bulk issuance

Dashboard CSV imports accept at most 1,000 rows and process them in chunks of 500.

Prepare the file

Use UTF-8 CSV with one header row. Include a recipient-name column and every required template field. Include recipient email only when you need dashboard records or SMTP delivery.

name,email,course,date,external_id
Aisha Verma,[email protected],Advanced TypeScript,2026-07-12,completion-1001
Diego Santos,[email protected],Advanced TypeScript,2026-07-12,completion-1002

Validate and map

CertKit validates the browser preview and repeats validation on the server. Map each CSV header to recipient.name, recipient.email, external_id, or a template field.

Delivery

SMTP can be selected only when the workspace has a verified active connection. Every selected row must map a valid recipient email. Delivery failures do not delete successfully issued certificates.

Results and retry

The batch page reports processed, issued, and failed rows. Download the error CSV, correct only failed rows, and submit a new batch. Reusing an external_id prevents accidental duplicate issuance.