Understanding Product Mapping
Learn what product mapping is, how it works, and why it’s essential for delivering digital files to customers.
What is Product Mapping?
Section titled “What is Product Mapping?”Product mapping is the process of linking your Shopify products to digital files or packs that customers will receive after purchase.
The Connection
Section titled “The Connection”Shopify Product ←→ Digital Files/Packs ↓ Customer Purchases ↓ Files Automatically DeliveredWithout product mapping: Customers buy product, but no files are delivered (manual process)
With product mapping: Customers buy product, files automatically delivered via app
Why Product Mapping Matters
Section titled “Why Product Mapping Matters”Automated Delivery
Section titled “Automated Delivery”Once you map products to files:
- ✅ Purchases automatically trigger file delivery
- ✅ No manual intervention needed
- ✅ Instant customer access
- ✅ Scalable (handles 1 or 1000 orders)
Flexibility
Section titled “Flexibility”Product mapping allows:
- Multiple files per product
- Multiple products per file (reuse files)
- Mix files and packs
- Variant-specific files
Customer Experience
Section titled “Customer Experience”Good product mapping ensures:
- Customers get exactly what they purchased
- All files delivered together
- Clear organization (ZIP files)
- Professional delivery
How Product Mapping Works
Section titled “How Product Mapping Works”The Flow
Section titled “The Flow”-
Merchant Setup
- Upload files to Alva Digital Downloads
- Create or select Shopify product
- Map files/packs to product
-
Customer Purchase
- Customer buys product on Shopify store
- Shopify marks order as “Paid”
- Shopify sends webhook to Alva app
-
Automatic Delivery
- App detects product purchase
- Looks up product mapping
- Generates secure download link
- Delivers via email/Thank You page/Account
-
Customer Download
- Customer accesses download link
- Files delivered as ZIP (if multiple) or individual file
- Secure, time-limited access
Types of Product Mapping
Section titled “Types of Product Mapping”1. Single File to Product
Section titled “1. Single File to Product”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
2. Multiple Files to Product
Section titled “2. Multiple Files to Product”One product = Multiple files
Example:
- Product: “Social Media Template Pack”
- Mapped Files:
instagram-template-1.psdinstagram-template-2.psdfacebook-cover.psdinstructions.pdf
- Customer receives:
social-media-template-pack.zip
Best for:
- Template collections
- Course materials
- Multi-file deliverables
3. Pack to Product
Section titled “3. Pack to Product”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
4. Mixed Mapping (Files + Packs)
Section titled “4. Mixed Mapping (Files + Packs)”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
5. Variant-Specific Mapping
Section titled “5. Variant-Specific Mapping”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)
Product Mapping Concepts
Section titled “Product Mapping Concepts”Default Variant Mapping
Section titled “Default Variant Mapping”Every product has a default variant mapping. This applies to:
- Products with no variants
- Products with variants (fallback if variant not specifically mapped)
Many-to-Many Relationships
Section titled “Many-to-Many Relationships”One File → Multiple Products: Same file can be delivered by multiple products
Example:
bonus-guide.pdfincluded 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
Product Mapping Metadata
Section titled “Product Mapping Metadata”ZIP Title
Section titled “ZIP Title”Customize the name of the ZIP file customers download:
Default: Product title Custom: Set your own (e.g., “Marketing-Bundle-2024”)
Download Type
Section titled “Download Type”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 Mapping States
Section titled “Product Mapping States”Active Mapping
Section titled “Active Mapping”- ✅ Product actively mapped to files
- ✅ Files will be delivered on purchase
- ✅ Appears in product mapping list
Inactive Mapping
Section titled “Inactive Mapping”- ⚠️ Product exists but no files mapped
- ⚠️ Orders won’t receive files
- ⚠️ Needs configuration
Broken Mapping
Section titled “Broken Mapping”- ❌ Product was mapped, but files were deleted
- ❌ Needs remapping
- ❌ Shows error in mapping list
Finding Products to Map
Section titled “Finding Products to Map”From Products Page
Section titled “From Products Page”- Go to Products in Alva app
- Browse or search Shopify products
- Click product to map
Product Statuses
Section titled “Product Statuses”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
Product Mapping Sync
Section titled “Product Mapping Sync”Shopify Sync
Section titled “Shopify Sync”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
Manual Sync
Section titled “Manual Sync”Force a sync if products aren’t appearing:
- Go to Products page
- Click Refresh Products button
- Latest products load from Shopify
Product Mapping Best Practices
Section titled “Product Mapping Best Practices”1. Map Immediately After Upload
Section titled “1. Map Immediately After Upload”Workflow:
- Upload files
- Immediately map to product
- Test download
- Publish product
Why:
- Don’t forget to map
- Avoid unmapped products going live
- Complete setup before selling
2. Use Descriptive ZIP Titles
Section titled “2. Use Descriptive ZIP Titles”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
3. Test Every Mapping
Section titled “3. Test Every Mapping”After mapping:
- Create test order
- Download files as customer would
- Verify all files present
- Check ZIP extraction works
4. Document Your Mappings
Section titled “4. Document Your Mappings”Keep a record of:
- Which products map to which files
- Product variations and their files
- Last mapping update date
Why: Easier troubleshooting and updates
5. Review Mappings Regularly
Section titled “5. Review Mappings Regularly”Monthly checklist:
- Check for broken mappings
- Update outdated files
- Remove mappings for discontinued products
- Verify all new products are mapped
Common Product Mapping Scenarios
Section titled “Common Product Mapping Scenarios”Scenario 1: eBook Store
Section titled “Scenario 1: eBook Store”Setup:
- One product per eBook
- Simple 1:1 mapping
- Single file delivery
Mapping:
Product: "Marketing Mastery eBook" → File: marketing-mastery.pdf → Download Type: Individual FileScenario 2: Template Marketplace
Section titled “Scenario 2: Template Marketplace”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-templateScenario 3: Video Course
Section titled “Scenario 3: Video Course”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: ZIPScenario 4: Software/Plugin
Section titled “Scenario 4: Software/Plugin”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.zipProduct Mapping vs. Fulfillment
Section titled “Product Mapping vs. Fulfillment”Digital Delivery (Alva)
Section titled “Digital Delivery (Alva)”Handles:
- ✅ Digital file delivery
- ✅ Download links
- ✅ Email notifications (optional)
- ✅ File access management
Shopify Fulfillment
Section titled “Shopify Fulfillment”Handles:
- Inventory
- Shipping (physical products)
- Order status
Integration: Alva can mark digital products as “fulfilled” automatically (optional setting)
Viewing Product Mappings
Section titled “Viewing Product Mappings”Product Mapping List
Section titled “Product Mapping List”Access all mappings from:
- Products page in Alva app
- Filter by:
- Mapped vs. Unmapped
- Product type
- Search by name
Product Details View
Section titled “Product Details View”Click any product to see:
- Mapped files/packs
- Download type
- ZIP title
- Variant mappings
- Recent orders
Next Steps
Section titled “Next Steps”Now that you understand product mapping:
- Mapping Files to Products - Step-by-step guide
- Bulk Product Mapping - Map many products at once
- ZIP Download Configuration - Customize ZIP delivery