Skip to main content

Run a Passport

The Passports page is off by default. Ask your Vibemap contact to turn it on for your organization.

Invite people to visit a set of places, redeem offers or complete tasks, and earn rewards in the Vibemap app.

A passport runs on one of your place lists. Its stops are the list's places, its offers come from those places, and it follows every edit to the list. People join it in the Vibemap app, where it is listed under Badges.

In the sidebar, click Passports.

Find a passport​

The page shows one card per passport: its cover, status, type, dates and the last 30 days at a glance (members or participants, redemptions or check-ins, last activity). Each card offers Build, Results and an actions menu.

With more than six passports, the page adds:

  • Tabs: All, Live, Scheduled, Drafts, Ended and Archived.
  • Search name, slug or organization.
  • A sort: Recently updated, Name, Start date or Most active.
  • A source filter: All sources, Hub or WordPress.
  • A switch between grid and table views.

Create a passport​

  1. Click New passport. A phone preview beside the steps fills in as you build.

  2. Choose its list: pick the place list the stops come from. A card marked Used by names a passport already running on that list. To make a new list, click Build a new list from a tag, a boundary, hand-picked places or a CSV; the list wizard opens in a new tab.

  3. Type & rules: pick a template, or Start blank:

    • Savings pass: members unlock offers at local businesses and redeem them in the app.
    • Check-in trail: a route of stops; members check in at each one.
    • Points challenge: members earn points for check-ins, shares and redemptions.
    • Event passport: a short-run passport for a festival or event weekend.

    Fits your list marks the template that suits the list you picked. Every rule stays editable after you create the passport.

  4. Story & look: enter a Name (required). The URL slug follows the name until you edit it, and locks once the passport is published. Add a Tagline, and set Starts and Ends, or leave both empty to run with no end date.

  5. Launch: check the summary and click Create draft.

Click Continue to move on and Back to return. Creating never publishes: the passport stays a draft, seen only by your team, until you launch it. The Hub opens it on Overview.

Build it​

A passport page has two modes: Build and Results. In Build, a step track runs across the top, each step with its status:

StepWhat you set
OverviewNothing to set: a map of the stops, Needs attention and The story so far
Identity & storyName, tagline, About, fine print and joining
Stops & offersThe list, and each partner's offer
TasksWhat members do at each stop
Look & feelCover art, sponsor and colors
Rules & rewardsLevels, rewards, an optional race and the prize
LaunchReadiness, visibility, schedule and the share link

The phone preview shows the passport as the app does. Switch it between Visitor, Member, Offer and Redeemed, and click any part of the phone to open the step that edits it.

For a step-by-step walk-through of one type, see Build a Stops & Tasks Passport.

On Identity & story, Look & feel, Rules & rewards and Launch, edits wait in a bar at the bottom of the step. Click Save, or Discard to drop them. Offers and tasks have their own save buttons.

Overview​

The map shows the stops. Switch its layer between Setup, Performance and Audience, and click a pin for that stop's numbers and offer. Needs attention ranks what to fix by its effect on members; each item has a button that opens the fix.

Identity & story​

  • Name and Tagline: the app title and the line under it, also shown on the join sheet.
  • About: the story under the cover and in the join prompt. To credit who runs the passport, write "Brought to you by …" here.
  • Save + Win: the prize hook.
  • Fine print: How it works (used by offers without their own how-to) and Terms.
  • More settings: link and badge family, call to action, updates, rewards, discounts and partners.
  • Joining & agreements: what members agree to when they join. Click Add agreement; with none, members join with one tap. A member's email reaches you only through an agreement that grants contact.

Stops & offers​

The band at the top names the list the stops come from, with Open list, Add places and Change list. Adding or removing a place here changes the list itself. On a Smart list, Add places explains that places join by the list's rules; change the rules on the list instead.

For a passport with offers, Partners & offers lists every partner:

  1. Use the tiles to filter: All stops, Untitled, No terms, No how-to, Open-ended and No redemptions.
  2. Click a partner to edit its offer: Title, Offer text, How to redeem, Terms and Ends. Leave Ends empty for an open-ended offer.
  3. Click Save offer. To add one, fill in Offer text and click Create offer.

Review suggested titles drafts a title for every untitled offer from its text, and Add how-to to fills in missing redemption steps; review the rows, then apply. Drag a partner's handle to set the passport order; the app still lists partners nearest first. Show phone and Hide phone toggle the preview.

For a check-in passport, Stops lists each stop with Points (overrides the app default for a check-in there), a Note only the Hub shows, and Counts, which pauses a stop without losing its settings.

Tasks​

Choose Every Stop, a single stop or Whole passport on the left.

  • How members progress shows the engine. Passports made in the Hub run on Stops and Tasks: each stop carries tasks.
  • Playing: Join required (only what members do after joining counts), Auto-approve unverified (a submission whose location can't be checked approves itself after 48 hours unless you reject it), Level style (Ladder or Milestones) and Before it starts.
  • Click Add Task and pick a kind: Check in, Scan a code, Take a photo, Answer a question, Add a vibe, Upvote a vibe, Redeem an offer, Save the place or Share the place. Whole passport adds Vibe check, Search vibes and Custom action.
  • Each task has a Title, Instructions, Required (off makes it a bonus task that never blocks the stop), Where (At the Stop or Anywhere), Passport Points and Review (hold the points until you approve the task in Results). Click Save Task.
  • A stop also has Codes (click Make code, then Print the QR; Stands in for GPS lets a code replace a location check; Revoke retires a code), Stop settings (Counts as here within, Presence lasts, In order, Completion Bonus, Visits earn points), Stop Groups and Unlocking (open a stop after others or a Level, and hide it behind a Clue).
  • Every Stop also holds Hunt order, which makes the stops a trail: each unlocks once the one before it is complete.

Look & feel​

  • Cover art: click Upload or Replace. The phone crops it to 390 × 300. Hub cover is a 16:9 image for Hub cards and share pages.
  • Sponsor: a name, a Link and a Logo shown under About.
  • Colour: the brand color comes from your organization's theme. Pass colours sets the Hub card's gradient when there's no cover art.

Rules & rewards​

  • Levels & Rewards: click Add a Level, then Add a requirement: Passport Points, Tasks done, Specific Tasks or Stops completed. Under Rewards, click Add a Reward and pick a kind: Claim in person (a one-time code staff redeem), Drawing entry (you draw winners), Unlock an offer or Information only. Click Save Level and Save Reward.
  • Race (optional): time members from the start to a finish line and rank them. Choose Mass start or Individual start.
  • Save + Win: the Prize members can win.

Launch​

  1. Ready to launch? lists what blocks publishing, each with a button to the step that fixes it. Tasks check lists what members could get stuck on; it doesn't block publishing.
  2. Under Visibility, set Show in app (listed under Badges) and Featured (pinned at the top of Badges). Join prompt shows what visitors see before they join.
  3. Under Schedule, click Set dates, or leave it Always on.
  4. Save your changes, then click Publish and confirm. Real players see the passport, so don't publish one you're only testing.

Share gives the Pass link, which opens the pass in the Vibemap app. Click Copy and use it on counter cards, window clings and newsletters.

Manage a passport​

The actions menu on its card, or beside Build and Results on the passport, offers:

  • Publish, or Unpublish (back to draft) for a live passport.
  • Archive, and Restore as draft for an archived one.
  • Duplicate…: a new draft with the same rules, branding and content. Give it a Name and Slug; Copy the stops too is on by default.
  • Delete…: only for a passport nobody has joined or checked in to. Otherwise, archive it.

Read the results​

Click Results. Pick a range (7D, 30D, 90D, YTD or All). The tabs are:

  • Report: headline numbers, charts and performance by stop.
  • Members: activity per member. Members are pseudonymous: you see activity, never names or emails. Click Export CSV to download the list.
  • Redemptions: redemption numbers and the Redemption log, which you can download as CSV.

A passport on Stops and Tasks adds:

  • Review: photos and unverified submissions waiting for you. Click Approve or Reject, or select several and use Approve all or Reject all. Rejecting reopens the task, and your note is shown to the member.
  • Rewards: who earned each reward. Under Hand over a Claim, type or scan a member's claim code; each code works once. For a drawing, click Draw a winner; winners are final.
  • Race: rankings, times and penalties, and finalizing the race.

How members use a passport​

Members find a published passport under Badges in the Vibemap app, version 4.7 or later; older versions don't show it. They join from the join sheet, then:

  • complete each stop's tasks, such as checking in nearby, scanning its code, taking a photo or answering a question;
  • redeem offers by tapping Redeem at the counter, which starts a 60-minute timer to show staff;
  • earn levels and rewards, and show their claim code to staff to collect a claimed reward.

Gotchas​

  • A passport needs a place list. Events lists don't appear in the list picker.
  • Stops follow the list. Editing the list, or adding and removing places on Stops & offers, changes every map and calendar that uses it too.
  • If creating fails with "Passports aren't enabled for this organization", ask your Vibemap contact to turn on the Passports product.
  • A passport WordPress manages shows Managed in WordPress, and its WordPress fields read Edit in WordPress.
  • Leaving a step with unsaved changes asks you first.