Importing Passports from a CSV File
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
Go to Import in the sidebar
Click Import in the left navigation.
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.
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.
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 namegtinโ 14-digit GTIN, no spaces or hyphenspassport_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
Go to Import
Click Import in the sidebar.
Upload your file
Drag your CSV file into the upload area, or click Browse Files and select it. Maximum file size: 10MB.
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.
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, andpassport_levelare 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.
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.
Need more help?
Contact support โRelated articles
Start building your Digital Product Passports
EU Battery Regulation compliance โ 18 February 2027 deadline.