Skip to content

Understanding Product Mapping

Learn what product mapping is, how it works, and why it’s essential for delivering digital files to customers.

Product mapping is the process of linking your Shopify products to digital files or packs that customers will receive after purchase.

Shopify Product ←→ Digital Files/Packs
Customer Purchases
Files Automatically Delivered

Without product mapping: Customers buy product, but no files are delivered (manual process)

With product mapping: Customers buy product, files automatically delivered via app


Once you map products to files:

  • ✅ Purchases automatically trigger file delivery
  • ✅ No manual intervention needed
  • ✅ Instant customer access
  • ✅ Scalable (handles 1 or 1000 orders)

Product mapping allows:

  • Multiple files per product
  • Multiple products per file (reuse files)
  • Mix files and packs
  • Variant-specific files

Good product mapping ensures:

  • Customers get exactly what they purchased
  • All files delivered together
  • Clear organization (ZIP files)
  • Professional delivery

  1. Merchant Setup

    • Upload files to Alva Digital Downloads
    • Create or select Shopify product
    • Map files/packs to product
  2. Customer Purchase

    • Customer buys product on Shopify store
    • Shopify marks order as “Paid”
    • Shopify sends webhook to Alva app
  3. Automatic Delivery

    • App detects product purchase
    • Looks up product mapping
    • Generates secure download link
    • Delivers via email/Thank You page/Account
  4. Customer Download

    • Customer accesses download link
    • Files delivered as ZIP (if multiple) or individual file
    • Secure, time-limited access

Simplest mapping: One product = One file

Example:

  • Product: “Marketing eBook”
  • Mapped File: marketing-guide.pdf
  • Customer receives: marketing-guide.pdf

Best for:

  • eBooks
  • Individual templates
  • Single audio tracks
  • Simple products

One product = Multiple files

Example:

  • Product: “Social Media Template Pack”
  • Mapped Files:
    • instagram-template-1.psd
    • instagram-template-2.psd
    • facebook-cover.psd
    • instructions.pdf
  • Customer receives: social-media-template-pack.zip

Best for:

  • Template collections
  • Course materials
  • Multi-file deliverables

One product = One pack (containing multiple files)

Example:

  • Product: “Complete Design Bundle”
  • Mapped Pack: “Design Bundle Pack” (contains 20 files)
  • Customer receives: complete-design-bundle.zip

Best for:

  • Bundles
  • Reusable file collections
  • Complex products with many files

One product = Multiple files + Packs

Example:

  • Product: “Ultimate Package”
  • Mapped:
    • Pack: “Templates Pack” (10 files)
    • Pack: “Bonuses Pack” (5 files)
    • Individual File: exclusive-guide.pdf
  • Customer receives: ZIP with all 16 files

Best for:

  • Complex bundles
  • Flexible product offerings

Different files for different product variants

Example: Product: “Printable Planner”

  • Variant: “US Letter Size” → Maps to planner-us-letter.pdf
  • Variant: “A4 Size” → Maps to planner-a4.pdf
  • Variant: “A5 Size” → Maps to planner-a5.pdf

Best for:

  • Size variations
  • Language versions
  • Edition differences (Basic vs. Pro)

Every product has a default variant mapping. This applies to:

  • Products with no variants
  • Products with variants (fallback if variant not specifically mapped)

One File → Multiple Products: Same file can be delivered by multiple products

Example:

  • bonus-guide.pdf included in:
    • Product A: “Starter Pack”
    • Product B: “Pro Pack”
    • Product C: “Enterprise Bundle”

Benefits:

  • Reuse files across products
  • Update once, applies everywhere (if linked dynamically)
  • Efficient storage usage

Customize the name of the ZIP file customers download:

Default: Product title Custom: Set your own (e.g., “Marketing-Bundle-2024”)

Choose how files are delivered:

ZIP (Default):

  • All files bundled in ZIP archive
  • Single download for customer
  • Best for multiple files

Individual Files:

  • Each file downloadable separately
  • No ZIP created
  • Best for 1-2 files or when ZIP not needed

  • ✅ Product actively mapped to files
  • ✅ Files will be delivered on purchase
  • ✅ Appears in product mapping list
  • ⚠️ Product exists but no files mapped
  • ⚠️ Orders won’t receive files
  • ⚠️ Needs configuration
  • ❌ Product was mapped, but files were deleted
  • ❌ Needs remapping
  • ❌ Shows error in mapping list

  1. Go to Products in Alva app
  2. Browse or search Shopify products
  3. Click product to map

Mapped (Green badge):

  • Product already has files mapped
  • Click to edit mapping

Unmapped (Gray badge):

  • Product exists but no files assigned
  • Click to create mapping

No Digital Products:

  • Standard products with no digital content
  • Can still be mapped if needed

The app automatically syncs with your Shopify product catalog:

Auto-synced:

  • New products appear in Alva app
  • Product title/status updates
  • Variant changes

NOT auto-synced:

  • File mappings (you control these)
  • Digital file assignments

Force a sync if products aren’t appearing:

  1. Go to Products page
  2. Click Refresh Products button
  3. Latest products load from Shopify

Workflow:

  1. Upload files
  2. Immediately map to product
  3. Test download
  4. Publish product

Why:

  • Don’t forget to map
  • Avoid unmapped products going live
  • Complete setup before selling

Good ZIP titles:

  • social-media-templates-bundle
  • video-course-module-1
  • lightroom-presets-vintage

Bad ZIP titles:

  • download
  • files
  • product-123

Why: Helps customers identify files after download


After mapping:

  1. Create test order
  2. Download files as customer would
  3. Verify all files present
  4. Check ZIP extraction works

Keep a record of:

  • Which products map to which files
  • Product variations and their files
  • Last mapping update date

Why: Easier troubleshooting and updates


Monthly checklist:

  • Check for broken mappings
  • Update outdated files
  • Remove mappings for discontinued products
  • Verify all new products are mapped

Setup:

  • One product per eBook
  • Simple 1:1 mapping
  • Single file delivery

Mapping:

Product: "Marketing Mastery eBook"
→ File: marketing-mastery.pdf
→ Download Type: Individual File

Setup:

  • Products with multiple file formats
  • Offer PSD + AI versions

Mapping:

Product: "Business Card Template"
→ Files:
- business-card-template.psd
- business-card-template.ai
- instructions.pdf
→ Download Type: ZIP
→ ZIP Title: business-card-template

Setup:

  • Course split into modules
  • Each module is a product

Mapping:

Product: "Module 1: Introduction"
→ Pack: "Module 1 Pack"
- lesson-1-video.mp4
- lesson-2-video.mp4
- lesson-3-video.mp4
- workbook.pdf
→ Download Type: ZIP

Setup:

  • Different builds for different platforms

Mapping:

Product: "Photo Editor Plugin"
Variant: "Windows"
→ File: photo-editor-windows.zip
Variant: "Mac"
→ File: photo-editor-mac.zip
Variant: "Linux"
→ File: photo-editor-linux.zip

Handles:

  • ✅ Digital file delivery
  • ✅ Download links
  • ✅ Email notifications (optional)
  • ✅ File access management

Handles:

  • Inventory
  • Shipping (physical products)
  • Order status

Integration: Alva can mark digital products as “fulfilled” automatically (optional setting)


Access all mappings from:

  1. Products page in Alva app
  2. Filter by:
    • Mapped vs. Unmapped
    • Product type
    • Search by name

Click any product to see:

  • Mapped files/packs
  • Download type
  • ZIP title
  • Variant mappings
  • Recent orders

Now that you understand product mapping:

  1. Mapping Files to Products - Step-by-step guide
  2. Bulk Product Mapping - Map many products at once
  3. ZIP Download Configuration - Customize ZIP delivery