Creating a Story
- Go to Marketing → Content in your dashboard
- In the Stories section, click Create Story
- Enter a title (displayed in the viewer)
- Add one or more pages (videos)
- Configure CTAs for each page
- Set the display order in the carousel
- Toggle the story to Active
- Click Create Story to save
Story Structure
Each story consists of:Pages
Each page within a story contains:Video Requirements
Videos are processed through Mux for optimised streaming across all devices.
Call-to-Action Types
Add to Basket
Adds the linked product directly to the customer’s basket.- Best for simple items without required modifiers
- If the product has modifiers, the item modal opens instead
- Highest conversion CTA type
View Item
Opens the product detail modal.- Use when products have modifiers to configure
- Allows customers to see full details before adding
View Category
Scrolls the menu to the selected category.- Closes the story viewer
- Useful for promoting entire menu sections
External URL
Opens an external link in a new tab.- Track clicks before the user leaves
- Use for bookings, events, or external content
None
No CTA button displayed.- Use for brand content or announcements
- Video plays without prompting action
Viewer Behavior
When a customer opens a story:
Videos start muted by default. Customers can tap the volume icon to unmute.
Progress Indicator
A progress bar at the top shows:- Current position within the story
- Number of pages in the current story
- Auto-advances when video completes
Metrics & Tracking
storekit tracks comprehensive story engagement:Key Metrics
Display Settings
Carousel Position
Stories appear in a horizontal carousel at the top of the menu page, above categories.Thumbnail Preview
Each story shows a looping video preview in the carousel. Customers tap to enter the full-screen viewer.Loading States
- Skeleton placeholders show while stories load
- Blur hash previews display before video is ready
- Spinner indicates video is buffering
Managing Stories
Reordering
Drag and drop stories to change their position in the carousel. First story appears on the left.Editing
Click a story to edit its pages, CTAs, or settings. Changes are saved immediately.Deleting
Delete stories to remove them permanently. This cannot be undone.Archiving
Toggle stories off to hide them without deleting. Useful for seasonal content you’ll reuse.Troubleshooting
Story is active but not visible on the ordering page
If a story shows as Active in the dashboard but doesn’t appear on your live menu page, work through these checks first:- Confirm it’s Active, not just saved - Open the story from Marketing → Content and check the toggle reads Active (green). A story left Inactive is saved but won’t display. Use the Active / All / Inactive filters to confirm its state.
- Check the right store is selected - Stories are assigned per store. Make sure the story is assigned to (and Active for) the store whose ordering page you’re viewing.
- Refresh the live page - Reload the ordering page (a hard refresh clears any cached version) so it picks up the latest content.
- Check its position in the carousel - The carousel sits at the top of the menu, above categories. A story lower in the display order may be scrolled off-screen - scroll the carousel sideways to find it.
- Wait for the video to finish processing - Videos are processed through Mux after upload. A story won’t render until its video is ready, which can take a few minutes for larger files.
- Check any scheduling - If you set a start or end date under Scheduling, priority & CTA overrides, the story only appears within that window.
If the story still doesn’t appear after these checks, contact support with the store name and story title.
Tips
- First frame matters - The thumbnail is auto-generated from the first frame
- Keep it short - 5-15 seconds per page performs best
- Sound optional - Design for muted viewing since videos start muted
- Rotate content - Fresh stories drive repeat engagement
- Match CTAs - Use “Add to Basket” for simple items, “View Item” for complex ones
- Track performance - Review metrics to optimize underperforming stories
Related Content
Stories Guide
Content strategy and best practices
Promotional Banners
Static visual content for the menu
Videos
Adding video to products