Creating Experiences
This guide walks you through the experience creation process, covering all the configuration options available for queues, draws, auctions, and appointments.
Starting the Creation Process
- Navigate to Experiences in the sidebar
- Click the Create Experience button
- Choose your experience type
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 |
| Description | No | Internal description (not shown to consumers) |
| Experience Type | Yes | Queue, Draw, Auction, or Appointment |
Product Selection
Select the product that consumers will access through this experience.
Caption: Select a product from your catalog
| Field | Required | Description |
|---|
| Product | Yes | The product to offer |
| Variant Options | No | Specific variants to include (if product has variants) |
Create products before experiences. Navigate to Products to add items to your catalog.
Audience Selection
Control who can access the experience by selecting an audience.
Caption: Select which audience can access this experience
| Field | Required | Description |
|---|
| Audience | Yes | The audience that can participate |
- Select a specific audience
- Select multiple audiences (consumers in any selected audience can participate)
- Leave empty for public access (no restrictions)
Schedule Configuration
Set when the experience starts and ends.
Caption: Configure when your experience runs
| Field | Required | Description |
|---|
| Start Date | Yes | When the experience opens for entries |
| Start Time | Yes | Time of day the experience starts |
| End Date | Varies | When the experience closes (not required for all types) |
| End Time | Varies | Time of day the experience ends |
| Time Zone | Yes | Time zone for all scheduled times (defaults to organization setting) |
Inventory Settings
Configure how many consumers can successfully complete the experience.
Caption: Set inventory limits for your experience
| Field | Required | Description |
|---|
| Total Quantity | Varies | Maximum successful entries/purchases |
| Per-Consumer Limit | No | Maximum entries per consumer |
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
- Inventory validation - Quantities must be positive numbers
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
After Creation
After successful creation:
- You’ll see a success notification
- You’ll be redirected to the experience detail page
- The experience will be in Draft status
Canceling Creation
To cancel and discard your progress:
- Click the Cancel button
- Confirm you want to discard changes
- You’ll return to the experiences list
Canceling 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 | Experience 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 inventory limits - Ensure quantities match your 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 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:
