This guide walks you through the experience creation process, covering the shared configuration used for queues, draws, auctions, appointments, and timed releases. Waitlists are configured on access paths when you want to capture interest before or around another distribution.
Starting the Creation Process
- Navigate to Experiences in the sidebar
- Click the Create Experience button
- Choose your distribution type or access path template
Caption: Select an experience type to begin configuration
Quick Links by Type
For type-specific configuration details, see:
Common Configuration Fields
All experience types share these configuration sections:
Caption: Enter basic information about your experience
| Field | Required | Description |
|---|
| Name | Yes | Display name for the experience |
| Distribution Type | Yes | Queue, Draw, Auction, Appointment, or Timed Release |
Product Selection
Select the product or product pool that consumers will access through this experience.
Caption: Select products from your catalog
| Field | Required | Description |
|---|
| Product | Yes | The product or product pool to offer |
| Variant Options | No | Specific variants to include (if product has variants) |
| Selection Mode | Varies | Consumer-selected products let consumers choose; system-assigned products use allocation settings |
Create products before experiences. Navigate to Products to add items to your catalog.
Audience Selection
Control who is eligible for an access path by selecting one or more audiences.
Caption: Select which audiences are eligible for this access path
| Field | Required | Description |
|---|
| Audience | Varies | Audiences whose members are eligible to participate |
- Select a specific audience
- Select multiple audiences for the same access path when those segments share eligibility
- Use separate sequences when different eligible groups need different ordering or treatment
- Leave empty for public access (no restrictions)
Schedule Configuration
Set the distribution window. Experience openAt and closeAt are derived from the distributions attached to its access paths.
Caption: Configure when your experience runs
| Field | Required | Description |
|---|
| Open Date | Varies | When the distribution becomes active |
| Open Time | Varies | Time of day the distribution becomes active |
| Close Date | Varies | When the distribution window ends |
| Close Time | Varies | Time of day the distribution window ends |
| Time Zone | Yes | Time zone for all scheduled times (defaults to organization setting) |
Capacity Settings
Configure distribution-specific capacity and outcome limits.
Caption: Set capacity limits for your distribution
| Field | Required | Description |
|---|
| Queue Capacity | Queue only | Maximum consumers waiting at once |
| Admit Rate | Queue only | Rate at which consumers are admitted |
| Max Admissions | Queue only | Maximum consumers who can be admitted |
| Winner Count | Draw only | Number of winners selected at draw time |
| Slot Capacity | Appointment only | Maximum bookings per slot |
| Guest Support | Timed Release only | Whether guest participants can claim the release |
| Waitlist Capacity | Waitlist access path | Maximum waitlist entries when a waitlist is configured |
Form progress is stored locally in your browser. Clearing browser data will reset your progress.
Validation and Errors
The form validates your input as you type:
- Required fields - Highlighted if empty when submitting
- Date validation - End date must be after start date
- Capacity validation - Numeric limits must be positive numbers where required
Caption: Validation errors appear inline as you complete the form
Creating the Experience
Once all required fields are complete:
- Review your configuration
- Click Create Experience
- Wait for confirmation
Caption: Click Create Experience to finish
Operational Follow-Up
After successful creation:
- You’ll see a success notification
- You’ll be redirected to the experience detail page
- The experience is saved with its configured access path, distributions, and derived schedule
Discarding Creation
To discard your progress:
- Click the discard action
- Confirm you want to discard changes
- You’ll return to the experiences list
Discarding clears your saved form progress. This cannot be undone.
URL Parameters
You can pre-fill certain fields using URL parameters when linking to the creation page:
| Parameter | Description | Example |
|---|
type | Distribution type | ?type=QUEUE |
name | Experience name | ?name=Summer%20Sale |
productId | Pre-select product | ?productId=prod_123 |
audienceId | Pre-select audience | ?audienceId=aud_456 |
/app/experiences/create?type=QUEUE&name=Summer%20Sale&productId=prod_123
- Creating experiences from other parts of the app
- Building custom workflows
- Developer integrations
Best Practices
Before Creating
- Prepare your product - Ensure the product exists with correct details
- Set up audiences - Create audience segments if you need restricted access
- Plan your schedule - Know your start/end times before beginning
During Configuration
- Use descriptive names - Include product and date for easy identification
- Double-check time zones - Verify the time zone matches your intended schedule
- Review capacity limits - Ensure limits match your launch plan and available stock
After Creation
- Preview the experience - Check how it appears to consumers
- Test with a sample entry - Verify the flow works correctly
- Set up notifications - Configure alerts for key distribution events
Troubleshooting
Common Issues
| Issue | Solution |
|---|
| Can’t find product | Create the product first in Products section |
| Audience not appearing | Verify the audience exists and has at least one consumer |
| Date picker not working | Ensure JavaScript is enabled in your browser |
| Form won’t submit | Check for validation errors (scroll up to see all fields) |
Getting Help
If you encounter issues:
- Check the error message for specific guidance
- Review the documentation for the specific experience type
- Contact support with the error details and request ID
Next Steps
After creating your experience:
