Quickstart

Quickstart: Seven steps to your first Digital Product Passport

By the end of this guide, you'll have a live Digital Product Passport (DPP) with a QR code anyone can scan to verify your product.

This guide walks you through creating your first product and sharing a verifiable Digital Product Passport.

Estimated time

30-45 minutes for your first passport. Subsequent products go much faster once you are familiar with the workflow.

Prerequisites

  • An active Universal Goods account with Organisation Admin access
  • Your organisation set up with a Universal Profile (completed during onboarding)
  • At least one product image ready to upload
Organisation setup first

If you have not yet created your organisation, do so during signup. You need an org with an active Universal Profile before you can create products. If you were invited to an existing organisation, confirm that your role includes product management permissions.

Step 1: Create a product

Navigate to Products in the sidebar and click Create Product.

Products page: create and manage your product catalog
The products page where you create and manage your product catalog

Fill in the product basics:

  • Name: The product line name (e.g., "Premium Leather Handbag"). This appears on the passport.
  • Description: A brief summary of the product. Keep it factual; this is the official product record, not marketing copy.
  • Category: Select the best-fit product category. This determines which data fields are available in the next step.
  • Product image: Upload a clear product photo. This is the hero image on the passport.

Click Save to create the product. You are now on the product detail page.

Step 2: Add product data

Open the Data tab to build out the product's full record. Data is organised into structured sections:

  • Identification: SKU, GTIN/barcode, model number, brand name, and other identifiers that uniquely identify your product in commercial and regulatory systems.
  • Physical Attributes: Dimensions, weight, color, size range, and other physical characteristics.
  • Provenance: Country of origin, manufacturing facility, production methods.
  • Composition: Material breakdown with percentages (e.g., "75% bovine leather, 15% cotton lining, 10% brass hardware"). Critical for regulatory compliance.
  • Circularity: End-of-life instructions: recyclability, disassembly guidance, take-back programs, repair information.
  • Documentation: Supporting files such as certifications (ISO, OEKO-TEX), lab test reports, compliance declarations, and care instructions.

Fill in each section relevant to your product. Required fields are marked. At minimum, complete Identification and Composition for a useful passport.

Start with what you have

You do not need to complete every section before sharing a passport. Start with the data you have available and add more sections over time. Product and batch data can be updated at any time, and integrity anchors can be refreshed with updated data.

Step 3: Create a batch

Navigate to the Batches tab on your product and click Create Batch.

Batch management: create and track production batches
Batch management view with production run details and item counts

Enter the batch details:

  • Title: A descriptive name for this production run (e.g., "March 2026, Milan Factory").
  • UID Prefix: A short prefix for item serial numbers in this batch (e.g., "PLH-2603"). Each item gets this prefix plus a sequential number.
  • Description: Optional notes about this production run: facility, conditions, or other batch-specific details.

Click Create to set up the batch. It starts in a draft state.

Step 4: Generate items

Inside your batch, go to the Items tab and click Generate Items.

Enter the quantity of items to create. Each item represents one physical product unit. The platform supports up to 5,000 items per batch.

For each item, the platform creates:

  • A unique digital identity on the blockchain — each item receives a DPP minted as an LSP8 token
  • A Unique Product Identifier (UPI) embedded in a QR code or NFC tag for physical-to-digital linking
  • A private key for verification
  • An activation code for consumer passport claiming

Large batches take a few seconds to generate.

Key generation is irreversible

Once items are generated, their blockchain identities exist permanently. Generate the correct quantity; you cannot delete individual items from a batch.

Step 5: Back up batch keys

After generating items, you must back up the private keys. Click Backup Keys in the batch toolbar.

You will be prompted to set a backup password. This password encrypts the key file. The platform does not store your backup password. If you lose it, the keys cannot be recovered.

The download is an encrypted file containing the private keys for all items in the batch. Store this file securely:

  • Keep it in your organisation's secure storage (password manager, encrypted drive, or HSM)
  • Do not email it, upload it to shared drives, or store it unprotected
  • Consider keeping a second copy in a different physical location
This is critical

Private keys prove each item's authenticity. If keys are lost and no backup exists, those items can no longer be verified. Treat key backups with the same care as financial credentials.

Step 6: Finalise batch items on-chain

Navigate to the Tokenisation tab in your batch. This is where you anchor the production records on the blockchain.

Click Finalise Batch Items. This triggers a blockchain transaction that:

  1. Freezes the item list: no items can be added to or removed from the batch after finalising
  2. Writes a hash of the batch's current data to the blockchain as an integrity anchor
  3. Registers each item's on-chain identity under your organisation's Universal Profile

The transaction takes 15-30 seconds to confirm. Once finalised, the batch status changes to Finalised. You can still update batch and product data after finalising, and refresh the integrity anchor with updated data.

Check the transaction

After finalising, you will see a transaction hash. You can click it to view the transaction on the block explorer, confirming the on-chain record independently.

QR Code Passport

Step 7: Share the passport

Go to the Share Passport tab (accessible from the product or batch level). Here you configure what consumers see:

  1. Select disclosure sections. Choose which data sections to include in the public passport. You might share Identification, Composition, and Circularity publicly while keeping detailed Provenance data private.

  2. Generate QR codes. The platform generates a unique QR code and shareable link for each item. These can be:

    • Printed on product packaging or hang tags
    • Embedded in NFC chips
    • Included in shipping documentation
    • Shared digitally via email or messaging
  3. Preview the passport. Click Preview to see exactly what a consumer will see when they scan the code.

Passport sharing: configure disclosure sections and generate QR codes
The passport sharing page: select sections, generate QR codes, preview the consumer view

What happens next

When a consumer scans the QR code or visits the passport link:

  1. They see the product's passport page with the sections you chose to disclose: materials, certifications, provenance, and care instructions.

  2. A verification check runs automatically, confirming the data matches the on-chain record and was issued by your organisation.

  3. The consumer can optionally claim the passport, associating it with their own profile as proof of owning an authenticated product.

Verification page: consumers see proof of authenticity
The verification page: consumers see all checks pass in real time

No app download or account creation is needed to view and verify a passport. The entire experience happens in a standard web browser.

Troubleshooting

ProblemSolution
Cannot create productsCheck that your role has product management permissions in Organisation Settings
Item generation is slowLarge batches (1,000+) take time for key generation. The process runs in the background, so do not close the browser.
Finalisation transaction failsEnsure your organisation's Universal Profile has sufficient funds for transaction costs (e.g., LYX on LUKSO). Check the network status if transactions are timing out.
QR code does not resolveVerify the batch is finalised. Passports are not publicly accessible until the batch is finalised on-chain.
Key backup download failsTry a different browser. The encrypted file can be large for big batches.

Next steps

  • How It Works: Understand the trust model and verification behind what you just built.
  • Connections: Set up partner connections to exchange certifications and compliance data.
  • API Reference: Automate product creation and passport sharing through the API.

You've created your first product, issued a batch, tokenised items with on-chain identities, and shared a verifiable Digital Product Passport. From here, explore the Guides for batch management, partner connections, and compliance workflows.