Help Center

Frequently asked questions

Quick answers to the questions we hear most often. Looking for something specific? Search below or browse by topic.

The Basics

What is Hopscotch?

A digital wallet for barcode-based loyalty cards. Scan your physical cards once and Hopscotch shows the right one when you arrive at the store. Works on iPhone and Apple Watch.

Is Hopscotch free?

Yes. There's no paywall, no subscription, no ads, no in-app purchases.

Do I need to create an account?

No. Hopscotch doesn't have accounts, sign-up, login, or passwords. You install the app and start scanning.

What iPhone do I need?

Any iPhone running iOS 17 or later. Apple Watch support requires watchOS 10 or later.

Will it work on iPad?

The app is built for iPhone. It runs on iPad in compatibility mode but isn't optimized for the larger screen.

Privacy & Data

Where is my data stored?

On your iPhone, period. Hopscotch has no accounts, no servers, and no cloud sync — your cards, locations, and settings live in iOS's on-device storage, not uploaded anywhere or kept on our end. (Adding a card to Apple Wallet is the one exception — see below.)

Do you track me?

No. No analytics, no third-party trackers, no behavioral logging. There's nowhere for that data to go even if we wanted it.

Does my location data leave my phone?

No. iOS handles geofence monitoring locally at the chip level. Hopscotch never sees your coordinates, location history, or where you've been.

What happens if I delete the app?

All your data is gone — there's nothing on a server to clean up. If you'd like to keep your cards, use iCloud Backup before deleting; restoring the app from backup restores your deck.

Are my cards backed up?

Only if you use iCloud Backup on your iPhone. In that case, Hopscotch data is included automatically alongside your other app data. There is no separate Hopscotch cloud backup.

Is my data encrypted?

Yes. iOS automatically encrypts everything Hopscotch stores on your device — your barcodes, card names, notes, photos, and saved locations — whenever your iPhone is locked.

How does iOS protect my data?

iOS uses a feature called Data Protection. Every file is encrypted with a key tied to your device's dedicated security chip (the Secure Enclave) and your passcode. That key can't be copied off the device, and your data can't be unscrambled without unlocking your phone. Face ID and Touch ID unlock that same protection.

Can the people behind Hopscotch see my cards?

No. There's no account system and no server that stores your cards, so there's nothing on our end to look at. The only moment any card data reaches us is when you add a card to Apple Wallet (below) — our pass service uses it to build that one pass, then discards it.

What about adding a card to Apple Wallet?

Adding a card to Apple Wallet is the only feature that sends card details to a server — ours — and only for the card you choose to add. We send that card's name, barcode, and color/category, plus the store locations you've set (so Wallet can alert you when you're nearby). It travels over an encrypted, tamper-verified connection; our pass service builds the pass and discards the details immediately — we never store your cards. From there, your pass lives in Apple Wallet and is governed by Apple's privacy terms.

Does my Apple Watch see my cards too?

Yes — your paired Apple Watch receives a copy of your cards from your iPhone over Apple's private, encrypted device-to-device link, and stores them encrypted on the Watch the same way. This stays between your own devices; it never passes through us or the cloud.

What happens if I lose my phone?

As long as your iPhone is locked and has a passcode, your card data stays encrypted and unreadable to anyone who finds it — which is exactly why a strong passcode matters.

What's the single best thing I can do to keep my cards safe?

Set a strong passcode, and turn on Face ID or Touch ID. Your screen lock is the root of all this encryption — it's literally the key. A phone with no passcode has far weaker protection, no matter which app you use. A strong passcode is your best defense.

Location & Geofencing

Why does Hopscotch want my location?

To notify you when you arrive at a store so the right card is ready. That's the entire feature.

Why does it need "Always Allow" specifically?

Geofencing only works in the background. "While Using the App" only checks your location when Hopscotch is open on screen — which means no automatic arrival notifications. To get the magic, choose Always Allow.

You can still use Hopscotch with "While Using" or "Never" — you just won't get arrival notifications.

Will this kill my battery?

No. Typical impact is 1–3% over a full day. Hopscotch never turns on GPS — iOS does region monitoring with low-power cell and Wi-Fi signals your phone is already processing. An hour of GPS navigation drains more battery than a full day of Hopscotch geofencing.

How many locations can I have?

iOS limits any single app to 20 monitored regions at once. Hopscotch shows your remaining slots when you're getting close. Toggle locations off without deleting them to free up a slot.

My geofence didn't fire — why?

Most common causes:

  • Location permission isn't set to Always Allow
  • Notifications are off for Hopscotch
  • Geofence radius is under 50m (try 100m+ — GPS isn't exact)
  • You were already inside the geofence when you set it up — region monitoring only fires on entry, not while you're standing still inside one
  • You arrived through a "dead zone" like underground parking that blocks cell/Wi-Fi signals
Can I use Hopscotch without giving location access?

Yes. You can still scan, store, and display cards — you'll just need to open the app and pick the card manually instead of getting an automatic notification.

Cards & Scanning

Which barcode formats does Hopscotch support?

Code 128, Code 39, EAN-13, UPC-A, QR, PDF417, and Aztec. This covers virtually every loyalty card on the market.

What if the barcode won't scan from my card?

Tap Enter manually and type the number. Then pick the format from the dropdown. Most loyalty cards print the barcode number directly above or below the bars — that's what you'll type.

Will the cashier's scanner read it off my phone screen?

Yes, in nearly all cases. Crank screen brightness to max and hand them the phone. A handful of older or very specific scanners can struggle with phone screens — in that case, the cashier can type the number from the on-screen display.

Can I add a card I don't have anymore?

Yes. Use Enter manually and type the barcode number from a receipt, email, or your account on the store's website.

Can I share a card with my partner or family?

Not currently. Each Hopscotch install is independent. If they have the physical card or know the number, they can scan/enter it on their own phone.

Widget & Smart Sort

What does the widget do?

Shows your most-relevant card on your home screen so it's one tap away. It uses Smart Sort to decide which card to show.

How does Smart Sort decide which card to show?

In this priority order:

  1. The card you've pinned (if any)
  2. A card whose geofence you're currently inside
  3. The closest geofenced store
  4. Your most-used cards
  5. Most recently scanned
  6. Alphabetical (as a tiebreaker)
Can I make the widget always show a specific card?

Yes — pin it. Long-press the widget → Edit Widget → pick the card → tap outside to confirm.

How do I unpin?

Edit the widget and choose Smart Sort (or whichever option clears the selection).

The widget shows the wrong card!

Smart Sort surfaced a card it thinks is more relevant — maybe one you scan often, or one closer to you. If you want a specific card every time, pin it.

Notifications

Will I get spam notifications?

No. Hopscotch only sends one type of notification: an arrival notification when you enter a geofence you've set up. Nothing else. Ever.

Why did I get two notifications when I arrived at a store?

You probably have the card saved both in Hopscotch and as an Apple Wallet pass:

  • The Hopscotch app notification is dismissible by swiping and auto-clears after 15 minutes.
  • The Apple Wallet pass notification is iOS's lock-screen pass — it persists while you're inside the geofence so you can tap-and-hold at checkout without unlocking the phone. iOS clears it when you leave the area.
How do I get rid of the persistent Wallet notification?

Open the pass in Apple Wallet → tap the ••• menu → toggle Suggest on Lock Screen off. This is an iOS Wallet setting, not a Hopscotch setting.

How do I mute notifications for one specific card?

Open the card and toggle the location off. The geofence is preserved; no Hopscotch notification fires. To also stop the Wallet pass from showing, use the Wallet toggle above.

Apple Watch

Does Hopscotch work on Apple Watch?

Yes, on watchOS 10 or later. The Watch app shows your card deck and can display any barcode for scanning at checkout.

Can I scan a new card on my Watch?

No — Apple Watch doesn't have a camera. Add cards on your iPhone; they sync to the Watch automatically.

Can I set geofences on my Watch?

No — manage locations on your iPhone. Geofence arrival notifications appear on whichever device(s) you have enabled.

My Watch isn't syncing the cards

Force-quit Hopscotch on the iPhone, re-open it, give the Watch 30 seconds. If that doesn't work, restart the Watch.

Apple Wallet

Do Hopscotch cards work in Apple Wallet?

Yes. Open a card in Hopscotch and tap Add to Apple Wallet to generate a pass. The pass shows your barcode and can be configured to surface on your lock screen when you arrive at the saved location.

Do I have to add a card to Wallet to use Hopscotch?

No. Wallet integration is optional. The Hopscotch app on its own handles scanning, storage, and barcode display.

If I remove a Hopscotch pass from Wallet, does it delete the card from the app?

No. Wallet passes and Hopscotch cards are separate. Removing one doesn't affect the other.

Trouble & Bugs

App is crashing

Force-quit and reopen. If it keeps crashing, restart your iPhone. If still broken, email hello@hopscotch.city with your iPhone model and iOS version.

App keeps asking for permissions

Go to Settings → Hopscotch → toggle the relevant permission (Camera / Location / Notifications) off, then back on.

I lost all my cards

If you have iCloud Backup enabled, deleting and reinstalling the app, then restoring from backup, will bring them back. Otherwise, cards are stored only on your device — there's no cloud copy.

Something else is wrong

Email hello@hopscotch.city with details. Screenshots help.

Roadmap

Is there an Android version?

Yes — Hopscotch is on Google Play, with a Wear OS companion. Switch to the Android tab above for download details.

Will I be able to sync between two iPhones?

On the roadmap, not in the current release. The app is local-only today.

Can I export my cards?

Not yet. Email if this is important to you — that signal helps us prioritize.

Still need help?

We're a small team and we read every message. Reach out and we'll get back within 1–2 business days.

Email us