๐Ÿ“ฅ Data Import & Export

Importing Passports from a CSV File

Updated 2026-04Essential reading

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

Getting the CSV template

1

Go to Import in the sidebar

Click Import in the left navigation.

1

Download the CSV template

Click "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 software

Open 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 headers

The template includes the exact column names DPP Cloud 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 DPP Cloud.

Uploading the CSV

1

Go to Import

Click Import in the sidebar.

1

Upload your file

Drag your CSV file into the upload area, or click Browse Files and select it. Maximum file size: 10MB.

1

Review the import preview

DPP Cloud scans the file and shows a preview: how many rows were found, how many are valid, and how many have errors.

1

Confirm import

Click Import to create Draft passports from all valid rows. Rows with errors are skipped โ€” you can fix and re-upload them.

๐Ÿ“ธ 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 field โ€” battery_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 individually

Imported 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.

Start building your Digital Product Passports

EU Battery Regulation compliance โ€” 18 February 2027 deadline.

Request demo account โ†’