Documentation/Data Import & Export/Importing Passports from a CSV File
Reference§03.04SectionData Import & ExportReg. ref.Annex XIIILast reviewed2026-04

§03.04 · DATA IMPORT & EXPORT

Importing Passports from a CSV File.

Getting the template, preparing your data, uploading, and handling import errors.

If you have battery passport data in a spreadsheet, you can import multiple passports at once using a CSV file. EU Digital Passport Processor validates each row and creates a Draft passport for every valid entry.

Getting the CSV template

  1. Go to Import in the sidebarClick Import in the left navigation.
  1. Download the CSV templateClick "Download CSV Template." The template file includes all Annex XIII column headers in the correct format, with example values in the first row.
  1. Open the template in your spreadsheet softwareOpen the downloaded CSV in Excel, Google Sheets, or any spreadsheet editor. The first row contains the column headers. The second row shows example values.
Use the template — do not build your own headersThe template includes the exact column names EU Digital Passport Processor expects. If you create your own headers, even small differences (e.g., "Battery_Category" vs "battery_category") will cause import errors. Start from the template and paste your data in.

Preparing your data

Fill in one row per passport. Each row must include at minimum:

  • battery_category — "EV" or "Industrial"
  • product_name — the battery name
  • gtin — 14-digit GTIN, no spaces or hyphens
  • passport_level — "model", "batch", or "item"

All other Annex XIII columns are optional at import — you can complete them later by editing the Draft passport in EU Digital Passport Processor.

Uploading the CSV

  1. Go to ImportClick Import in the sidebar.
  1. Upload your fileDrag your CSV file into the upload area, or click Browse Files and select it. Maximum file size: 10MB.
  1. Review the import previewEU Digital Passport Processor scans the file and shows a preview: how many rows were found, how many are valid, and how many have errors.
  1. Confirm importClick Import to create Draft passports from all valid rows. Rows with errors are skipped — you can fix and re-upload them.
Reference image: upload panel

Import results and job history

After the import completes, the Import page shows the job in the Import History section. Each job shows:

  • The filename and upload date.
  • How many passports were created.
  • How many rows had errors (if any).

Click on a job to see the detailed results, including error messages for any failed rows.

Handling errors

Common import errors:

  • GTIN format — must be exactly 14 digits, no spaces, no hyphens.
  • Missing required fieldbattery_category, product_name, gtin, and passport_level are required.
  • Invalid category — must be exactly "EV" or "Industrial" (case-sensitive).
  • Duplicate GTIN + level — a passport with this GTIN and level already exists in your account.

Fix the errors in your CSV and re-upload. Only the corrected rows need to be in the new file — previously successful rows are already created.

CSV import creates Drafts — each passport must be activated individuallyImported passports are created in Draft status. You must open each one, review the data, and activate it individually to generate the GS1 Digital Link QR code. Bulk activation is not currently available.
REL Related entries
SectionEntryReviewed
Field ReferenceCSV Import Column Reference2026-04
Data Import & ExportUsing the Data Mapper2026-04
Passport CreationAnnex XIII: What Data You Need2026-04