Getting started
How do I add a verification code?
Three ways:
- Scan a QR code — tap Add New on the main screen and point the camera at the QR your service shows when you turn on 2FA.
- Tap an
otpauth://link — if you receive the setup link in Mail, Messages, or Notes, just tap it. iOS will offer Jumpstash in the "Set Up Codes In…" picker. - Enter manually — paste the base32 secret your service shows alongside the QR. Useful when you're setting up 2FA on the same device that's running Jumpstash.
Do I need to create an account?
No. Jumpstash has no accounts, no sign-up, no email verification. Install the app and you can start adding codes immediately. Your codes live in your iCloud Keychain — that's the only "account" involved, and it's the same one your iPhone already uses for saved passwords.
Does Jumpstash work offline?
Yes — TOTP codes are computed entirely on-device from a secret and the current time. No internet connection is needed to generate a code. The only network thing the app touches is iCloud Keychain syncing, which Apple handles transparently in the background.
Sync & devices
How do my codes sync between iPhone, iPad, Mac, and Apple Watch?
Automatically, through iCloud Keychain. As long as iCloud Keychain is turned on (Settings → your name → iCloud → Passwords & Keychain), every device signed in to your Apple ID sees the same codes within seconds. Apple's documentation calls this end-to-end encrypted — Apple itself can't read the contents, and neither can we.
I got a new iPhone — how do I get my codes back?
Sign in to your Apple ID on the new device, make sure iCloud Keychain is enabled, install Jumpstash from the App Store, and open it. Your codes are already there.
If you didn't have iCloud Keychain enabled and don't have an exported backup file, your codes can't be recovered from Jumpstash — the secrets only ever lived on the old device. In that case, contact each service whose 2FA you had set up; they all have a reset process.
Does Jumpstash work on the Mac?
Yes. Jumpstash on macOS is a menu-bar app — click the Jumpstash icon in your menu bar, see your codes, click to copy. It shares the same iCloud Keychain as the iOS apps, so the list stays in sync.
Does Jumpstash work on Apple Watch?
Yes. The watch app installs alongside the iPhone app and shows your codes on your wrist. The complication can also show one "pinned" code right on your watch face — pick it from the complication picker in the watch face editor.
AutoFill
How do I turn on verification-code AutoFill?
Settings → Passwords → AutoFill → Set Up Codes In… → toggle on Jumpstash.
After that, whenever Safari or any iOS 18+ app shows a "one-time code" field, iOS will offer your Jumpstash code as an AutoFill suggestion. Tap it; the code drops into the field.
AutoFill isn't offering my code. Why?
A few common reasons:
- Jumpstash isn't enabled as a code provider — see the previous question.
- The website is using a non-standard field. AutoFill recognises
fields marked with
autocomplete="one-time-code"; some sites haven't updated their markup yet. - The issuer name in your Jumpstash code doesn't match the website's domain. Edit the code (tap and hold, then Edit) and set the issuer to something close to the site name.
If none of those fix it, send us the site URL and we'll take a look.
Backup & portability
How do I export my codes?
Tap Backup on the main screen. Jumpstash gives you three options:
- JSON file — a lossless dump of every code. Perfect for restoring into Jumpstash later, on a different device or after a fresh install.
otpauth://URIs — one per line, the standard format every other authenticator app understands.- QR codes — for importing into a different authenticator that prefers scanning.
The backup file contains your TOTP secrets in cleartext — treat it like a password. Store it somewhere encrypted (an iCloud Drive folder is fine), or delete it after the restore.
Can I move my codes to a different authenticator?
Yes. Export as otpauth:// URIs or QR codes — both
are standard formats supported by Authy, 1Password, Bitwarden,
Aegis, Raivo, Apple Passwords, and pretty much every other TOTP
app. Your codes aren't locked in.
What if Jumpstash goes away one day?
Your codes are still yours. They live in your iCloud Keychain,
and the export feature produces standard otpauth://
URIs that any other authenticator can import. As long as you have
a backup, you can move to another app in minutes — no migration
process to depend on us for.
Privacy & security
Does Jumpstash see my codes?
No. Jumpstash has no servers, no analytics SDK, no telemetry, and no Jumpstash account. Your TOTP secrets are stored in your own iCloud Keychain, encrypted end-to-end by Apple, and visible only on your own devices. The full details are in our Privacy Policy.
Face ID isn't unlocking the app.
Try these in order:
- Make sure Face ID is enabled in iOS settings and that Jumpstash hasn't been denied biometric access (Settings → Face ID & Passcode → Other Apps).
- Force-quit and relaunch the app.
- If Face ID still fails repeatedly, iOS falls back to your device passcode after a few attempts — that always works.
Troubleshooting
The code I copied was rejected by the website.
TOTP codes rotate every 30 seconds. If you copy a code at the very last second, it may have already rolled by the time you paste it. Wait for the countdown ring to reset, then copy again.
If the code is consistently wrong, the most likely cause is a clock-skew issue on your device. Settings → General → Date & Time → make sure Set Automatically is on.
I can't find a specific code in my list.
The search bar at the top of the list matches both the issuer and the account name. The #-A-Z index on the right edge jumps straight to a letter — tap it, or drag-scrub to navigate quickly.
I deleted a code by accident.
Jumpstash writes a single-step backup of your previous keychain state before every save — but it's a single slot, not a history. If you haven't made any other change since the delete, you may still be able to recover by reinstalling the app from a previous iCloud backup or restoring an exported JSON. Otherwise the service whose code you deleted can reset 2FA from their account settings.
Reporting a bug
What should I include in a bug report?
To help us reproduce the issue:
- Device (e.g. iPhone 16 Pro, iPad Air M2, MacBook Pro)
- iOS / iPadOS / macOS / watchOS version
- Jumpstash version (Settings → About on iOS; About Jumpstash in the macOS menu)
- What you were doing when the issue happened, and what you expected vs. what you got.
- A screenshot or screen recording if the issue is visual.
Send all of that to support@jumpstash.app.