Skip to content
GUIDED ONBOARDING OVERLAYS

Guide every user from Add to Wallet to first pass use

PassTour adds temporary, artwork-matched instruction overlays to newly issued Apple Wallet and Google Wallet passes — then automatically disappears once the holder completes their first action.

Apple Wallet pre-install & post-install
Google Wallet separate overlay design
Auto-clears on scan, redeem, or timer
Sanitized custom SVG support (1 MB)
Interactive PassTour Preview

Guided Tour Overlay State

CancelAdd
Grand Palazzo
Hotels & Resorts
HONORS TIER
Elite Diamond
Get Your Pass

Click Add on the top right to get your pass!

HONORS NO.
GP-84920
STAY POINTS
1,200 pts
GUEST NAME
Clara Costa
Grand Palazzo PassTour QR preview
GP-2026-84920
Step 1 · Apple Wallet

Don't see Add? Open the pass in Wallet App

Pre-install sheet on Apple Wallet — disappears automatically once saved

WHY PASSTOUR IS NEEDED

Why wallet passes need temporary guided onboarding

Native wallet viewers give new holders very subtle UI cues. Without contextual onboarding, users stall before tapping Add or never discover where offers and pass actions live.

01

Users miss the Add button on preview sheets

When customers open a pass link inside social in-app browsers, iOS Safari, or email previews, many close the sheet without tapping Add in the top-right corner — leaving the pass unsaved.

02

Offers and Pass Details sit behind (...) or (⋮)

Valuable pass actions — member perks, voucher links, full balances, and update terms — live inside Apple Wallet's (...) button or Google Wallet's (⋮) menu, where new wallet users rarely look.

03

Permanent tutorial arrows ruin brand design

Baking helper arrows into your permanent strip image forces loyal customers to look at onboarding callouts for months. PassTour only overlays artwork while guidance is still relevant.

Without PassTour
  • Static strip images cannot distinguish a preview sheet from a saved pass
  • Holders overlook back-of-pass links, voucher actions, and Pass Details menus
  • Hardcoded UI arrows stay on the pass even after customers know how to use it
With PassTour
  • Shows an explicit Add to Wallet arrow on Apple preview sheets until saved
  • Transitions to an Installed overlay pointing directly to (...) or (⋮)
  • Restores your clean base artwork automatically after first scan, redeem, or timer

STATE MACHINE LIFECYCLE

Three automatic stages — never stuck after completion

Each issued pass tracks its own tour state (PRE_INSTALL -> POST_INSTALL -> COMPLETED), reacting automatically to wallet registration and usage events.

01Apple Wallet only · PRE_INSTALL

Pre-Install: Guide the tap on Add

Rendered exclusively on the Apple pre-install sheet before iOS saves the pass. Includes a top-right Add cue and a bottom fallback helper for restricted in-app browsers. Disappears once iOS confirms registration.

02Apple Wallet & Google Wallet · POST_INSTALL

Post-Install: Highlight Pass Details

Activates automatically once Apple Wallet saves the pass or immediately for Google Wallet passes (which skip Stage 1). Points holders to Apple's (...) menu or Google's (⋮) menu using your selected preset.

03Automatic artwork restoration · COMPLETED

Completed: Clean Original Artwork

When your chosen exit trigger fires, Passinstance marks the pass tour complete and pushes a live pass update — removing the temporary overlay so holders see your crisp original strip or hero image.

01Pre-Install: Guide the tap on AddApple Wallet only · PRE_INSTALL
Pre-Install: Guide the tap on Add
Rendered exclusively on the Apple pre-install sheet before iOS saves the pass. Includes a top-right Add cue and a bottom fallback helper for restricted in-app browsers. Disappears once iOS confirms registration.
02Post-Install: Highlight Pass DetailsApple Wallet & Google Wallet · POST_INSTALL
Post-Install: Highlight Pass Details
Activates automatically once Apple Wallet saves the pass or immediately for Google Wallet passes (which skip Stage 1). Points holders to Apple's (...) menu or Google's (⋮) menu using your selected preset.

Stamp Card Precedence & Screen-Reader Fallback

On stamp-card templates, rendered stamp artwork retains visual precedence so stamp progress stays readable; PassTour text guidance remains visible in the native Pass Details field (passinstance-tour-guide), alongside configurable accessibilityLabel copy for VoiceOver and TalkBack.

HOW TO USE PASSTOUR

How to configure PassTour inside Passinstance Studio

Follow these six steps inside Template settings -> Guided tour, preview every state live, and push overlays without touching your base strip artwork.

01

Open Guided tour & enable PassTour

In Passinstance Studio, open Template settings -> Guided tour on your template and switch on Enable PassTour.

02

Configure Step 1 (Add to Wallet)

Edit the Apple-only Headline, Top instruction line, and Bottom helper line — or upload an optional sanitized SVG overlay (up to 1 MB).

03

Pick a Step 2 preset (Use your pass)

Choose Redeem in Pass Details, Scan in-store, or Check out offers — or write custom post-install copy and directional guidance.

04

Customize Google Wallet (optional)

Toggle Customize separate Google Wallet design to write vertical menu (⋮) copy or attach distinct artwork for Google Wallet holders.

05

Select your exit trigger & locales

Pick when the overlay clears automatically (first scan, first redemption, mechanic execution, timer, or manual) and add locale overrides.

06

Verify Preview layers & sync passes

Toggle Apple/Google, Base/Tour/Final layers, and Add to Wallet/Installed/Completed in Live Preview, then save, publish, or sync existing passes.

Interactive Studio Walkthrough

Inspect every control in Pass Tour Overlay

Dashboard view1 / 2
Key UI elements

Step 1: Add to Wallet configuration & Apple Add sheet preview

Configure the pre-install Headline, Top instruction line, Bottom helper line, and preview 'Click Add on the top right to get your pass!' live before publishing.

EXIT TRIGGERS & CAPABILITIES

Control exactly when overlays disappear

Choose any of five lifecycle exit conditions and pair them with Google Wallet overrides, custom SVG overlays, and live template sync.

Supported PassTour Exit Triggers

PRE_INSTALL → POST_INSTALL → COMPLETED
FIRST_SUCCESSFUL_SCAN

After first successful scan

Automatically removes the tour overlay as soon as your staff or gate validates the pass for the first time with Passinstance Scanner.

FIRST_REDEMPTION

After first redemption

Ideal for coupons, gift cards, and points perks — keeps onboarding visible until the holder completes their first reward or balance redemption.

FIRST_MECHANIC_EXECUTION

After first mechanic execution

Completes the tour when the first dynamic pass mechanic runs (stamp added, points credited, tier upgraded, or dynamic field updated).

AFTER_DURATION

After configured duration

Counts down a configurable duration in seconds starting from confirmed wallet installation, then pushes the clean artwork update automatically.

NEVER

Keep active until disabled

Pins the post-install guidance layer permanently on issued passes until you turn off PassTour or publish an updated template state.

AUTO_SYNC

Re-Arm & Push Sync to Live Passes

Publishing updated onboarding tips? Optionally re-arm passes that already completed the tour, or run Sync to existing passes across Apple Wallet and Google Wallet.

Three Ready-to-Use Step 2 Presets

Switch cleanly between Redeem in Pass Details, Scan in-store, and Check out offers with concise mobile character budgets ready for lock screens.

Independent Google Wallet Guidance

Enable Customize separate Google Wallet design when you want Google holders to see (⋮) vertical-menu instructions without altering Apple Wallet copy.

Sanitized Custom SVG Overlays (Optional)

Need branded arrows or illustrated hints? Upload independent .svg files up to 1 MB for Step 1 Apple, Step 2 Apple, and Step 2 Google — sanitized server-side.

Re-Arm & Push Sync to Live Passes

Publishing updated onboarding tips? Optionally re-arm passes that already completed the tour, or run Sync to existing passes across Apple Wallet and Google Wallet.

FAQ

Frequently asked questions about PassTour

Does PassTour permanently change my template strip artwork?

No. Your base strip or hero artwork stays completely intact. PassTour renders the onboarding layer only while a pass is in Pre-Install or Post-Install, then pushes an update that restores your clean original artwork upon completion.

Why does Apple Wallet show Step 1 while Google Wallet starts at Step 2?

iOS displays an intermediate Add preview sheet before a pass is saved to Apple Wallet, so Step 1 directs users to tap Add. Google Wallet saves passes directly during the Google Wallet save flow, so those passes start directly in Step 2 (Installed).

How does PassTour behave on stamp card templates?

Generated stamp grid artwork always takes visual precedence so customers can read their stamps clearly. Your PassTour guidance text still surfaces safely inside the native Pass Details field.

Can I localize overlay copy and set screen-reader accessibility labels?

Yes. PassTour supports per-locale headline, instruction, and helper translations alongside explicit accessibilityLabel text and a native passinstance-tour-guide detail field fallback for assistive readers.

Launch guided wallet pass onboarding in minutes

Turn on PassTour in Passinstance Studio so every new holder adds their pass, finds rewards faster, and ends with clean brand artwork.