Setting up Digital Passport with your Akeneo PIM

A step-by-step guide to generating Digital Product Passports and QR codes from your product data.

Before you begin, make sure you have:

• An Akeneo PIM account (Growth or Enterprise edition)
• Products with attribute values in your PIM - the passport displays existing product data
• Admin access to your PIM (to install apps from the App Store)

1

Install the app from the Akeneo App Store

1. In your Akeneo PIM, go to Connect > App Store
2. Search for "Digital Passport"
3. Click Connect
4. Review the permissions - we request read-only access to your products, catalog structure, and channel settings
5. Click Authorize

You'll be redirected to the Digital Passport admin dashboard. That's it - you're connected.

2

Create a passport configuration

A passport configuration defines what a Digital Product Passport looks like for a set of products.

1. Click + New Configuration on the dashboard
2. Give it a name (e.g. "EU Fashion Passport" or "Electronics DPP")
3. Select the Channel - this determines which scopable attribute values are used
4. Select the Locale - this determines which localizable attribute values are shown

3

Select your attributes

This is where you decide what product data appears on the passport.

1. In the Passport Attributes section, you'll see all your PIM attributes on the left
2. Use the search bar to filter by name or code
3. Click an attribute to add it to the passport
4. For each selected attribute, you can set a Section - this groups attributes on the passport (e.g. "Materials", "Origin", "Sustainability")
5. The live preview on the right updates in real-time as you add/remove attributes

Common attributes to include:

• Fashion/Textiles: material composition, country of origin, care instructions, recyclability
• Food & Beverage: ingredients, allergens, nutritional info, origin, certifications
• Electronics: components, energy rating, repairability score, hazardous substances

4

Customize appearance

Brand the passport to match your identity:

• Primary Color - used for the passport header gradient
• Secondary Color - second gradient color
• Logo URL - your brand logo, shown in the passport header
• Passport Title - e.g. "Digital Product Passport" or "Product Traceability"

Changes are reflected instantly in the live preview. Click Save when you're happy.

5

Generate QR codes

From the dashboard, click QR Codes on your configuration.

1. Enter a product identifier (the SKU/identifier from your PIM)
2. Click Load
3. You'll see:
   • A live preview of the passport page (exactly what consumers will see)
   • A QR code with download buttons (PNG and SVG)
   • The passport URL and QR image URL
4. Click Download PNG or Download SVG to save the QR code

6

Bulk QR generation

Need QR codes for hundreds of products?

1. Click Bulk QR Generation from the QR Codes page
2. Paste your product identifiers - one per line or comma-separated
3. Click Download ZIP

The ZIP contains:

• qr-{identifier}.png - 400x400px QR code for each product
• manifest.csv - a CSV mapping identifiers to passport URLs and QR image URLs

7

Print QR codes on product labels

Once you have your QR codes:

• Add them to your label templates in your design software (InDesign, Illustrator, Canva, etc.)
• For automated label systems, use the QR image URL directly - most label printers can fetch images from a URL
• Recommended minimum size: 2cm x 2cm (0.8" x 0.8") for reliable scanning

When a consumer scans the QR code with their phone camera, they're taken directly to the passport page - no app download required.

API Reference

For integration with label printing systems, ERP, or other tools:

Passport page (HTML)

GET https://passport.avocaday.com/passport/{config_id}/{product_identifier}

Passport data (JSON)

GET https://passport.avocaday.com/api/v1/passport/{config_id}/{product_identifier}

QR code image (PNG, 300x300)

GET https://passport.avocaday.com/passport/{config_id}/{product_identifier}/qr.png

QR code image (SVG)

GET https://passport.avocaday.com/passport/{config_id}/{product_identifier}/qr.svg

Frequently Asked Questions

What happens if I update product data in the PIM?

Passport pages are cached for the duration you configure (default: 1 hour). After the cache expires, the next visitor sees the updated data. You can also manually clear the cache from the admin dashboard.

Can I use different passports for different markets?

Yes. Create multiple configurations with different channels and locales. Each gets its own set of QR codes.

What if a product doesn't have a value for a selected attribute?

It's automatically hidden on the passport. Only attributes with values are shown.

Do consumers need to install an app to scan?

No. The QR code opens a standard web page. Any phone camera app works.

Is my data secure?

Yes. API credentials are encrypted at rest. We only request read access. All data is deleted when you disconnect the app. See our Privacy Policy.

How do I disconnect the app?

Go to Connect > Connected Apps in your PIM and click Delete. All your data is immediately and permanently removed from our servers.