Overview
The Puzzle Game template is a gamified experience where users slide and rearrange scrambled tiles to reconstruct a hidden image — all before the countdown timer runs out. Completing the puzzle unlocks a reward. Failing to finish in time routes users to a consolation screen with the option to try again.
This template includes:
Intro Screen — introduces the challenge and invites users to start
Puzzle Screen — displays the sliding tile puzzle with a countdown timer
You Won Screen (Outcome 3b) — shown when the user completes the puzzle in time
You Loose Screen (Outcome 3a) — shown when the timer runs out before the puzzle is solved
Preview the experience: Puzzle Game
Before configuring logic or content, we recommend first applying your brand styling and updating the experience copy.
⚠️ Note on JavaScript Permissions
|
When to Use This Template
This template is ideal for:
Campaigns that reward effort or skill — users must complete a challenge to earn a prize
Brand or product reveals — the puzzle image can be a product, mascot, or campaign visual
Seasonal or event-based activations where a time-limited mechanic adds urgency
Engagement campaigns that keep users interacting for longer than a standard quiz
Lead generation with an incentivized reward tied to puzzle completion
Common Business Goals
Engagement & Time-on-Site
Lead Generation
Brand Awareness
Product Discovery
Promotional Activation
Example Use Cases
Retail / Ecommerce: reassemble a product image to unlock a discount code
CPG / FMCG: reconstruct a brand mascot or seasonal visual to reveal a prize
Media / Publishing: uncover a hidden image or headline to unlock exclusive content
Template Structure
This experience contains the following screens and components:
Component | Purpose |
Screen 1 — Intro Screen | Introduces the experience, explains the challenge, and invites the user to start. |
Screen 2 — Puzzle Screen | Displays the sliding tile puzzle, the countdown timer, and a movement counter. The user must solve the puzzle before time runs out. |
Screen 3a — You Loose | Shown when the timer expires before the puzzle is completed. Displays a consolation message and a CTA to try again. |
Screen 3b — You Won | Shown when the user completes the puzzle in time. Displays the prize, a coupon code, and an optional CTA. |
Countdown Timer | A native platform timer set to 118 seconds by default. Configurable via Screen Controls. Routes to the You Loose screen when it expires. |
Movement Counter | Displays the number of tile moves the user has made. Updates live as the user plays. |
Confetti Animation | Triggered on the You Won screen to celebrate completion. Powered by the canvas-confetti library. |
Understanding how these pieces work together will make customization easier.
Creating an Experience from This Template
To launch this template:
Navigate to Builder → Template Gallery.
Locate the template in the Gamification section in the template gallery.
Hover over the template and select Use Template.
Enter a name for your experience.
(Recommended) Apply your Style Guide to automatically brand the experience.
Click Create.
The platform will generate a new experience using the template structure and selected branding.
Once created, you can customize the content, design, and recommendation logic to fit your specific use case.
💡 Tip: We recommend creating and applying a Style Guide before launching templates to streamline setup and maintain consistent branding across experiences.
Step 1: Apply Your Brand Styling
The first step is to replace the template branding with your own. If your Style Guide is already created, this will happen automatically during template creation.
Review and update:
Colors
Fonts
Logos
Background Images
Buttons
Imagery
Applying your branding first makes it easier to visualize the final experience as you customize content and recommendations.
Haven't created a Style Guide yet?
No problem. You can still apply your branding directly within the experience.
From the Builder Map, select the Design icon in the toolbar.
The Experience Style Guide modal will open
Update your colors, fonts, logos, buttons, and imagery.
Click Apply to update all screens.
Recommended Action
Complete all branding updates before modifying copy, logic, or outcomes. Applying your style guide first makes it easier to visualize the final experience before updating content. Review Style Guide Overview for more details and instructions.
Step 2: Customize the Introduction Screen
The introduction screen sets expectations for the challenge and motivates users to participate. It should clearly communicate what they will do and what they can win.
Review and Update
Headline — describe the challenge (e.g., 'Piece It Together', 'Can You Crack It?')
Supporting copy — explain the mechanic and the reward
CTA button text — use action-oriented language
Background image or gradient
Logo
Best Practice
Keep the intro screen brief. Users are eager to play — use one short sentence to explain the mechanic and one sentence to describe the reward. Avoid lengthy copy that slows down entry into the game.
Step 3: Customize the Puzzle Screen
The Puzzle Screen is the core interaction of this experience. It displays the scrambled tile puzzle, the countdown timer, and a live move counter.
✅ YOU CAN EDIT:
|
Review and Update
Screen title and subtitle
Puzzle image — replace with your own product, brand, or campaign visual
Grid size — adjust difficulty via Custom Javascript (requires JS Hook permissions)
Piece border color — adjust via Custom CSS
Updating the grid size:
Best Practice
Choose a puzzle image with strong visual contrast and recognizable details — the image needs to be identifiable even when scrambled into tiles. Product shots, brand mascots, and bold campaign visuals work best. Avoid images with large uniform areas (e.g., solid backgrounds) as they make the puzzle harder to solve and less visually engaging.
Step 4: Configure Additional Experience Elements
Countdown Timer
The Puzzle Screen includes a native countdown timer that ends the experience and routes the user to the You Loose screen when it expires. The timer is configured directly in the Screen Controls panel — no JavaScript required.
To update the timer duration:
Select the Puzzle Screen in the editor
Open Edit Controls in the left panel
Locate the Timer section under Screen Duration
Update the Seconds value (default: 118 seconds)
Optionally adjust the animation style and colors to match your brand
Review and Update
Timer duration (Seconds) — set a value appropriate for your puzzle difficulty
Animation style — choose from the available countdown display options
Primary and Secondary colors — update to match your brand palette
Best Practice
Match timer duration to grid size. A 3×3 grid (9 pieces, default) works well with 90–120 seconds. If you increase to a 4×4 grid (16 pieces), extend the timer to at least 150–180 seconds to keep the experience fair and completable.
Confetti Animation
The You Won screen triggers a confetti burst animation to celebrate the user completing the puzzle. This animation is powered by the canvas-confetti library, already injected into the template via the Javascript Hooks panel.
To confirm the library is loaded:
Click the three-dot menu (⋮) on the experience
Select "Edit Javascript Hooks"
Confirm the following URL is listed under Inject JS Libraries:
Review and Update
Confirm the confetti library is injected (Inject JS Libraries tab)
Confetti colors are pre-configured to a purple/white palette — they can be updated in the On Show script if needed (requires JS Hook permissions)
Best Practice
Do not remove the confetti library injection. The confetti function is called from the You Won screen's On Show script — if the library is missing, the screen will produce a JavaScript error.
⚠️ Javascript Hook Permissions Required
|
Step 5: Configure the Lead Capture Screen
This template does not include a dedicated lead capture screen by default. You can add one between the Puzzle Screen and the results screens if you want to collect user information before revealing the outcome.
Form Fields
If you add a lead capture screen, determine which information you want to collect:
Email Address
First Name
Last Name
Phone Number
Custom Fields
Opt-In Language
Update all consent language to align with your organization's legal and compliance requirements. Examples include:
Marketing consent language
Privacy policy references
Terms and conditions
Hyperlinks
Ensure all links point to the correct destinations:
Privacy Policy
Terms of Service
Additional compliance resources
Best Practice
Keep forms as short as possible while collecting the information required for your business objectives. Placing the lead capture screen after the puzzle is solved — but before the prize is revealed — creates a high-motivation moment for form completion.
Step 6: Configure Results and Outcomes
This template uses a completion-based outcome structure. The user is routed to You Won if they complete the puzzle before the timer runs out, or to You Loose if the timer expires first.
You Won Screen (Outcome 3b)
✅ YOU CAN EDIT:
|
You Loose Screen (Outcome 3a)
✅ YOU CAN EDIT:
|
Review and Update
Outcome headlines and descriptions on both screens
Prize value or reward text on the You Won screen
Coupon code (static or dynamic)
CTA buttons and labels
Background images or colors
Best Practice
Even on the losing screen, ensure there is a meaningful next step. The "TRY AGAIN" CTA reloads the puzzle and gives users another chance to engage and earn the reward — this drives repeat interactions and extends time-on-experience.
Step 7: Configure Logic
Logic Type: Completion-Based Routing
How It Works
This template does not use scoring or weighted probability logic. Routing is determined entirely by the puzzle mechanic itself:
If the user assembles all tiles in the correct order before the timer expires → You Won screen
If the timer reaches zero before the puzzle is solved → You Loose screen
There are no outcome weights to configure. The Outcome panel is used only to manage the content and CTAs on each result screen.
Logic Considerations
Difficulty is controlled by two variables: grid size (number of tiles) and timer duration
Grid size is set in the Custom Javascript on the Puzzle Screen (requires JS Hook permissions)
Timer duration is set in Screen Controls — no code required
The puzzle shuffle is randomized on every load, so no two sessions start from the same configuration
Best Practice
Test multiple playthroughs at your chosen grid size and timer duration before publishing. Aim for a completion rate that feels achievable but not too easy — a 40–60% completion rate tends to maximize engagement and return visits.
Step 8: Test the Experience
Before publishing, complete a full testing pass to ensure everything works as expected.
Review
Branding and styling across all screens
Content updates (headlines, descriptions, CTA labels)
Puzzle interaction on both desktop and mobile
Timer countdown and expiry routing (confirm it routes to You Loose)
Puzzle completion routing (confirm it routes to You Won)
Confetti animation on the You Won screen
Coupon code display (if applicable)
Lead capture functionality (if added)
Legal and compliance language
Mobile responsiveness
Test Scenarios
Run multiple test scenarios to verify:
Completing the puzzle routes correctly to the You Won screen and triggers confetti
Allowing the timer to expire routes correctly to the You Loose screen
The movement counter increments correctly with each tile swap
The puzzle shuffles to a new configuration on reload / Try Again
The experience renders and plays correctly on a touch device
Best Practice
Test on a mobile device specifically — the sliding tile interaction is touch-based on mobile and should feel responsive. Also verify that the timer animation displays correctly at your chosen duration.
Next Steps
Once testing is complete, your experience is ready to publish and generate launch links.
Continue optimizing by:
Monitoring completion vs. time-out rates in the Analytics panel and adjusting the timer or grid size accordingly
A/B testing different puzzle images to see which drives higher engagement and completion
Adding a lead capture screen to tie prize delivery to email opt-in
Configuring outcome URLs on the You Won screen to redirect winners to a checkout or redemption page
Customizing the Try Again CTA on the You Loose screen to re-enter the puzzle flow
For additional assistance, refer to the platform documentation or contact your support team.
Frequently Asked Questions
How does the puzzle know when the user has won?
The puzzle engine checks tile positions after every move. When all tiles are in their correct positions, the You Won screen is triggered automatically — no additional configuration is needed.
Can I change the grid size (number of tiles)?
Yes. The default grid is 3×3 (9 pieces). You can change it to 4×4 (16 pieces) or another size by updating the grid size value in the Custom Javascript on the Puzzle Screen. This requires Javascript Hook permissions on your account.
Can I change the puzzle image?
Yes. The puzzle image is a standard image element on the Puzzle Screen. You can replace it with any custom image — a product shot, brand mascot, campaign visual, or logo. The puzzle engine automatically slices the image into tiles based on the grid size.
Can I adjust the timer duration?
Yes. The timer is a native platform element configured under Screen Controls on the Puzzle Screen. Update the Seconds field to any value. No code changes are required.
Can I add a lead capture screen?
Yes. A lead capture screen can be added between the Puzzle Screen and the result screens. Placing it after completion — before the prize is revealed — creates the highest motivation to complete the form.
Can I remove the confetti animation?
Yes. The confetti animation is triggered from the You Won screen's On Show script. You can disable it by removing the triggerConfetti() call from that script. This requires Javascript Hook permissions on your account.
Can I remove the movement counter?
Yes. The movement counter is a display element on the Puzzle Screen and can be removed or hidden via the screen editor without any code changes.