Troubleshooting

Apple Wallet Pass Won't Add? 9 Common Causes and Fixes

18 November 2026 · 6 min read

An Apple Wallet pass usually fails to add for one of a few simple reasons: it was opened in the wrong app, saved as a file instead of opened, or sent to a phone that cannot read it, such as an Android device. Most of these take under a minute to fix.

Below are nine common causes in the order they are worth checking, plus an honest note on what you can and cannot fix yourself.

First, what should happen

When a pass opens correctly on an iPhone, a sheet slides up showing a preview of the card with Cancel and Add buttons. If you see that sheet, tap Add and you are done. If you see a blank page, a download icon, a wall of code or nothing at all, one of the causes below is in play.

1. You are on an Android phone

Apple Wallet passes are an Apple format. Android phones cannot open them, and Google Wallet support is not available yet. If the person who received your card uses Android, no setting will change that. They need an iPhone, or you need to send the card to someone who has one.

Links opened inside another app's built-in browser, such as the in-app viewer of a social or chat app, often cannot hand the pass over to Wallet. The page loads, but the Add sheet never appears.

Fix: copy the link and paste it into Safari, or use the share button and choose Open in Safari.

3. The file was saved instead of opened

This is one of the most frequent causes. Some browsers treat a .pkpass as a plain download and put it in a folder. Wallet never sees it.

Fix:

  1. Open the link in Safari on the iPhone.
  2. If the pass came by email, open the message in Mail and tap the attachment.
  3. If it is already saved, find it in the Files app and tap it.

4. You are on a computer, not the iPhone

A pass opened on a Windows PC or a non-Apple desktop will usually just download a file. Even on a Mac, the clean path is to send the link to the iPhone and open it there. Design on a computer if you like, but add the pass on the phone that should hold it.

5. The pass is incomplete or invalid

Wallet is strict. A pass is a signed bundle with a pass.json, images and a signature, and if something required is missing or the signature does not match, iOS refuses it without a helpful message. Reviewers of pass-making apps often describe this from the other side: an Add to Apple Wallet button that will not respond until hidden requirements such as an icon, logo text or organisation name are filled in.

Fix: if you built the pass yourself, check that every required field is filled and make the pass again. If someone sent it to you and it fails everywhere, the pass itself is probably faulty, and the sender needs to recreate it.

6. It is the wrong file type

A pass must be a real .pkpass file. If it was renamed, zipped, converted to a PDF or sent as a screenshot, Wallet will not read it. A picture of a pass is just a picture.

Fix: ask for the original link or the original .pkpass file. If you were sent a ZIP, extract it and open the .pkpass inside using Files.

7. The iOS version is the problem

Some passes use features that only exist on newer software. The poster-style, full-photo layout needs iOS 27, and older iPhones show a simpler pass instead. That simpler version should still add normally. If it does not add at all, check that the iPhone is not running a very old iOS release, then update through Settings, General, Software Update.

Details on the new layout are in the iOS 27 poster pass explained.

Links do not always last forever. A WalletGreet gift link works for 48 hours. After that it will not open, even though it looked fine when it arrived.

Fix: ask the sender for a fresh card. Each payment covers one pass and one gift link, so a new link means a new pass. If you are the sender, open the link yourself as soon as you receive it and send it close to the moment it is needed. More on timing is in how to send a Wallet card as a gift.

9. The iPhone itself is blocking it

If the pass is fine and the app is right, the phone may be the cause.

  • Low storage. A very full iPhone can fail to save new items. Free some space and try again.
  • Restrictions. Screen Time content and privacy restrictions, or a work-managed device, can limit what Wallet accepts. Check Settings and Screen Time, or ask whoever manages the device.
  • A stuck session. Close Safari fully, reopen the link, and tap Add again. Restarting the phone also clears many one-off glitches.

Try the add sheet again, in this order

If you do not know which cause applies, run through this short list:

  1. Use an iPhone, not Android.
  2. Open the link in Safari, not inside another app.
  3. Check the link is less than 48 hours old, if it is a gift link.
  4. Make sure the iPhone has free storage and is up to date.
  5. Close Safari, reopen the link and tap Add again.

What you can and cannot fix

You can fix almost everything that comes from where, how and when the pass was opened: the wrong app, a saved file, a desktop browser, an expired link, low storage. You cannot fix a pass that was built wrongly, a signature Wallet rejects, or an Android phone. For those, the answer is a new pass from the sender, or an iPhone.

Not every issue has a single clear cause, either. We have not tested passes on Apple Watch, so we cannot offer guidance there. If you are stuck, contact support with your iPhone model and iOS version.

For the full set of common complaints about pass-making tools in general, see what pass app reviewers complain about.

Start fresh

If a pass is beyond saving, the quickest route is a new one. Create your card with a live preview, then open it on an iPhone and tap Add. For a gift that needs to arrive on time, try birthday cards, and for the step-by-step method see how to add a photo to Apple Wallet.

Frequently asked questions

Why does my Wallet pass download but never open the Add screen?

Usually the file was saved instead of opened. Open the link directly in Safari, or open the attachment from Mail or the Files app, so iOS recognises the pass and shows the Add sheet.

Can I add an Apple Wallet pass on an Android phone?

No. Android phones cannot open Apple Wallet passes, and Google Wallet support is not available yet. The pass has to be opened on an iPhone.

My gift link says it has expired. What now?

A WalletGreet gift link works for 48 hours, so an older link will not open. Ask the sender to create a new card, since each payment covers one pass and one gift link.

What if none of these fixes work?

Write to support@walletgreet.com with your iPhone model, your iOS version and what you see on screen. A screenshot of the problem helps a lot.