Documentation Index
Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt
Use this file to discover all available pages before exploring further.
Products
Products are the items consumers can purchase through your experiences. Fanfare supports products with variants, inventory tracking, and images — everything you need for launches and sales.
Product Basics
Each product includes:
- Name — What consumers see
- Description — Product details
- Price — Base price for the product
- URL — Link to the product page on your store
- Images — Product photos
Product Variants
Variants represent different options like size and color:
Product: "Classic Sneaker"
├── Variant: White / Size 9 — $129.99
├── Variant: White / Size 10 — $129.99
├── Variant: Black / Size 9 — $129.99
└── Variant: Black / Size 10 — $139.99 (premium color)
Variant Properties
| Property | Description |
|---|
| SKU | Unique identifier for inventory |
| Price | Can override the base product price |
| Inventory | Stock count (if tracked) |
| Options | Size, color, or other attributes |
Variant-Specific Pricing
Variants can have different prices from the base product:
- Base price: $129.99
- Premium variant: $139.99 (rare color)
- Standard variants: Use base price
Inventory Tracking
You can choose whether to track inventory for each variant:
Tracked Inventory
When inventory is tracked:
- Stock count decreases with each purchase
- Consumers see “sold out” when quantity reaches zero
- Helps prevent overselling
Untracked Inventory
When inventory is not tracked:
- Always shows as available
- Useful for digital products or made-to-order items
Product Images
Add images to showcase your products:
- Primary image — Main product photo (shown in listings)
- Gallery images — Additional photos (shown on detail pages)
- Variant images — Specific to each variant (e.g., color photos)
Images display in the order you set, with the primary image first.
Products in Experiences
Connect products to experiences to make them available:
Single Product Experiences
Most common — one product per experience:
Experience: "Limited Edition Sneaker Drop"
└── Product: Air Max Limited
Multiple Product Experiences
Offer several products in one experience:
Experience: "Summer Collection Launch"
├── Product: Summer Tee (Primary)
├── Product: Beach Shorts
└── Product: Sun Hat
Variant-Specific Experiences
Link to a specific variant for exclusive launches:
Experience: "Exclusive Red Edition"
└── Product: Classic Sneaker
└── Variant: Red / Size 10 only
Product Selection Modes
Control how consumers choose products:
| Mode | Description | Best For |
|---|
| Consumer chooses | Consumers pick their product/variant | Most launches |
| Random assignment | System assigns randomly | Mystery boxes |
Syncing Products
Import products from your existing store:
| Platform | Sync Type | What Syncs |
|---|
| Shopify | Automatic | Products, variants, inventory, images |
| CSV Import | Manual | Product data you provide |
| API | Programmatic | Full control via API |
How Sync Works
Your Store Fanfare
┌─────────────┐ ┌─────────────┐
│ Product │ ─── sync ───► │ Product │
│ updated │ │ updated │
└─────────────┘ └─────────────┘
│ │
│ ▼
│ Experience shows
│ updated info
│
│ ┌─────────────┐
└─────── │ Inventory │ ◄─── Stays in sync
│ webhook │
└─────────────┘
Keeping Inventory Synced
For tracked inventory:
- Webhooks — Real-time updates when stock changes
- Periodic sync — Regular checks for changes
- Manual sync — Trigger a sync when needed
Pricing Best Practices
Enter Prices With Cents
Enter prices as you’d see them in your store:
- Example: 129.99 for $129.99
- Prices display in your configured currency
Consider Variant Pricing
- Set a base price for standard variants
- Use price overrides for premium variants
- Keep pricing consistent across your store
Managing Products
Create Products Manually
Add products directly in Fanfare:
- Enter product details (name, description, price)
- Add variants if needed
- Upload images
- Link to experiences
Import from Your Store
Sync products from your e-commerce platform:
- Connect your store
- Select products to import
- Products stay synced automatically
Update Products
Changes sync automatically when connected to your store. Manual updates are reflected immediately.
Best Practices
SKU Strategy
Use consistent, meaningful SKUs:
PRODUCT-COLOR-SIZE
SNKR-RED-10
TSHIRT-BLU-M
Inventory Accuracy
- Sync inventory frequently
- Set up webhooks for real-time updates
- Build in safety stock for high-demand launches
Image Quality
- Use high-resolution images
- Show multiple angles
- Include variant-specific images for colors
Keep Prices Synced
Ensure prices in Fanfare match your checkout:
- Sync regularly
- Test the full purchase flow
- Check variant-specific pricing
Next Steps
