First Passport

This walkthrough creates a basic Digital Product Passport for a product SKU.

Step 1: Verify Template Availability

Navigate to Catalog >Digital Product Passports > Templates and ensure at least one template is active. The module ships with:

• Generic DPP Template (ESPR)
• Textile DPP Template (ESPR/CIRPASS)
• Battery Passport (EU Battery Regulation)

You can also create your own template code if needed.

Step 2: Open a Product

Edit a product in the Magento catalog and locate the Digital Product Passport section.

Step 3: Fill Passport Data

Provide the required fields for the selected template, for example:

• Template code
• Status (Draft, Active, Published, Archived)
• ESPR category
• HS/CN code
• Country of origin
• DPP payload (JSON)

Status behavior:

• If you set a status manually (Draft, Active, Published, Archived), that value is used.
• If no status is selected, the module derives status from completeness score + configured threshold.

Step 4: Publish

Set status to Published when the data is ready for public/API output.

Important:

• Published passports must contain valid JSON payload data.
• Payload must match the template schema requirements.
• If schema/payload validation fails, save/publish will fail.

Step 5: Verify the Public View

Open the passport view page to confirm the output and QR code:

• Standard view: /dpp/index/view/id/{passport_id}
• GS1 Digital Link (if enabled): /01/{GTIN} (optional batch and serial qualifiers)

Next Step

Learn about GS1 Digital Link or JSON-LD output.