Build a Stops & Tasks Passport
A passport sends members to a set of places. At each Stop they do Tasks (check in, scan a code, take a photo, answer a question) and earn Passport Points, Levels and Rewards. You build it in Passport Studio, preview it on your phone, publish it, then review what members send in.
Before you start
- Passports must be on for your organization. If it isn't in the Hub sidebar, ask Vibemap.
- Put your places on a List first. Every place on the list becomes a Stop.
- Members need the Vibemap app 4.7 or later.
1. Create the draft
- Go to Passports and click New passport.
- Choose its list: pick the list your Stops come from.
- Type & rules: pick a template, or Start blank. You set Tasks and Levels after you create the draft.
- Story & look: enter the Name and a one-line Tagline. Set Starts and Ends, or leave them blank to run with no dates.
- Launch: check the summary and click Create draft.
The draft opens in Passport Studio. Nobody outside your team sees it. The Studio has two modes, Build and Results. Build runs left to right: Overview, Identity & story, Stops & offers, Tasks, Look & feel, Rules & rewards, Launch.
2. Check the Stops
Open Stops & offers. It shows the list the Stops come from.
- Add places adds a place to the list, and so to the passport.
- Change list moves the passport to another list.
The passport follows the list: a place added to or removed from the list is added to or removed from the passport.
3. Add Tasks
Open Tasks. The left column has three kinds of entry:
- Every Stop: Tasks that apply at each Stop.
- One entry per Stop: that Stop's own Tasks.
- Whole passport: Passport Tasks, done anywhere.
A new passport starts with a Check in Task under Every Stop, plus a bonus Redeem an offer Task when the passport has offers. Open each one to set its points.
To add a Task, select an entry, click Add Task and pick a type.
| Task | The member… |
|---|---|
| Check in | Checks in near the Stop. |
| Scan a code | Scans the Stop's QR code in the app, or types its code. See Stop codes. |
| Take a photo | Takes a photo. Only the member and your team see it. |
| Answer a question | Answers a trivia or survey question. |
| Add a vibe | Adds a vibe to the place. |
| Upvote a vibe | Upvotes one of the place's vibes. |
| Redeem an offer | Redeems the Stop's offer. |
| Save the place | Saves the place. |
| Share the place | Shares the place. |
Under Whole passport the types are Vibe check, Search vibes and Custom action. A Custom action is something the app can't check: the member taps I did it.
Click a Task to edit it, then click Save Task:
- Title and Instructions: what the member reads.
- Required: on, the Task is needed to complete the Stop. Off, it's a Bonus Task: extra points, never blocks the Stop.
- Where: At the Stop needs the member in range of the Stop, or a code that stands in for GPS. Anywhere doesn't.
- Passport Points: paid when the member completes the Task. New Tasks start at 10.
- Review: holds the points until you approve the submission in Review.
- Camera roll (photo Tasks): off means in-app camera only. On is weaker proof, so turn on Review with it.
- Which code (scan Tasks): any of the Stop's codes, or one in particular.
A question Task shows No question yet until you write one. Below its settings, pick the Kind (Single choice, Multiple choice, True or false, Fill in the blank, Number or Rating), write the Question, mark the answer, and click Create question. Turn Graded off for a survey, where any answer counts. Attempts, Hints and Explanation are optional.
Use the arrows on a row to reorder Tasks.
4. Set each Stop's radius and bonus
Select a Stop in the left column. Under Stop settings:
- Counts as here within: how close, in meters, a member must be. Leave it blank to use the passport's radius, shown in the box (644 m, about 0.4 mi, by default). Use 10 to 50,000 m. In a dense downtown, 100 to 150 m keeps members from reaching several Stops from one spot.
- Presence lasts: how many minutes At-the-Stop Tasks stay open after the member is in range, for basements and weak signal. The default is 30.
- In order: Required Tasks unlock one after another.
- Completion Bonus: extra points once every Required Task at this Stop is done.
- Visits earn points: a Visit is a check-in from beyond the radius. It earns points if this is on, but never completes an At-the-Stop Task.
Click Save Stop.
5. Make Stop codes
A Stop code is a QR to print, with a short code to type. Select a Stop and, under Codes, click Make a code:
- Add a Label, such as Front door sticker. Leave Code blank to get one made for you.
- Optional: Active from, Active until, and Most players (how many members can use it).
- Turn on Stands in for GPS if a scan should count as being at the Stop.
- Click Make code.
A code does something only when the Stop has a Scan a code Task, or when Stands in for GPS is on. With it on, a scan opens the Stop's At-the-Stop Tasks for the Presence lasts window, without GPS.
Click the QR icon on a code, then Print. The sheet shows the QR, the Stop, the passport and the code. Members scan it in the Vibemap app, or type the code.
Revoke stops a code at once, printed copies included. Members keep what they earned with it. Make a new code to replace it.
6. Add Levels and Rewards
Open Rules & rewards. Under Levels & Rewards, click Add a Level.
- Name the Level.
- Choose All of these or Any one of these.
- Set each requirement. A new Level starts at 5 Stops completed; change it, or click Add a requirement:
- Passport Points: at least this many points.
- Tasks done: at least this many Tasks, of one type or any, optionally at different Stops.
- Specific Tasks: these Tasks, ticked from a list.
- Stops completed: at least this many Stops, from any Stop or from a Stop Group.
- Optional: a Completion Bonus in points, and a description. The description shows only in the Hub; members don't see it.
- Click Save Level. The line under the name reads the Level back as a sentence.
Levels form a Ladder by default: in order, and reaching one also grants every Level below it. For separate goals reached in any order, choose Milestones under Tasks › Playing › Levels.
To give a Reward, click Add a Reward on a Level. Give it a title, and pick a kind:
- Claim in person: the member gets a one-time code. Your staff redeem it under Results › Rewards › Hand over a Claim.
- Drawing entry: each member who reaches the Level is entered. Draw winners under Results › Rewards.
- Information only: the title is the message; there's nothing to hand over.
Members see a Reward's title, not its description (app 4.7). Put what they get and how to pick it up in the title, or in About.
Set Stock (blank is unlimited) and Claim by if the Reward runs out or expires. Click Save Reward.
Save + Win is a prize line. It shows in the Studio phone preview, but app 4.7 doesn't show it on a Stops & Tasks passport, so put the prize in About as well.
7. Finish the story and look
- Identity & story: Name, Tagline, About, How it works and Terms. Joining & agreements sets what members agree to when they join. A member's email reaches you only through an agreement that lets you contact them.
- Look & feel: Cover art, Hub cover, sponsor and colours. Publishing needs Cover art or a Hub cover.
8. Preview it
The phone beside each step shows the passport's look and story as you edit. It doesn't show Tasks.
To play the draft on your own phone:
- Ask Vibemap to link your phone's Vibemap account to your Hub login. You do this once.
- On that phone, open the Pass link from Launch › Share.
The app marks the passport Preview. What you do is a test: it stays out of reports and is wiped when you publish. To see your test submissions in Review, tick Show preview.
9. Publish
Open Launch.
- Ready to launch? lists what blocks publishing, each with a link to the step that fixes it. A passport needs a name, Cover art or a Hub cover, at least one Task, at least one Level with a requirement, and a list with places.
- Tasks check lists things members could get stuck on. They don't block publishing, but fix them first.
- Under Visibility, keep Show in app on. Turn on Featured to pin it at the top of Badges. Set the Schedule if it has dates.
- Save any changes, click Publish, then Publish again to confirm.
The app (4.7 and later) lists the passport under Badges for members in its city, from its start date or right away. Share the Pass link on counter cards, window clings and newsletters.
You can keep editing a live passport. Changes reach members when you save. Removing a Task or Level never takes away what members earned.
10. Review photos
Open Results › Review. It lists the submissions waiting on you:
- Tasks with Review on (Needs your review).
- Submissions whose location couldn't be checked (Location unverified). If Auto-approve unverified is on under Tasks › Playing, these approve themselves after 48 hours unless you reject them.
Each card shows the photo or answer, the member, the time, the distance from the Stop, and any flags, such as From the camera roll, Looks like another photo or GPS far from the Stop.
- Approve pays the points.
- Reject reopens the Task so the member can try again. Add a note; the member sees it in the app.
- Tick several cards to Approve all or Reject all.
To see every photo, not only those waiting, set the status filter to Everything and the Task filter to Take a photo. Submissions and Players download CSVs.
More options
- Stop Groups (Tasks › Every Stop): named sets of Stops a Level can count, like "5 from Uptown".
- Hunt order and Unlocking: Stops that unlock in order, or after a Level, and can hide behind a Clue.
- Race (Rules & rewards): time members from the start to a finish line and rank them.
- Playing (Tasks): Join required, and what the Teaser shows before the start date.