PKPASS (Apple Wallet) file format

.pkpass · package (signed ZIP) · introduced 2012 by Apple

What is a PKPASS (Apple Wallet) file?

A .pkpass file is an Apple Wallet pass: a signed ZIP containing pass.json (the pass content), images, and a manifest.json with SHA-1 hashes of all files plus a PKCS#7 signature. Boarding passes, event tickets, loyalty cards, and coupons all use this format.

Most readers reach this page after double-clicking a .pkpass file and finding their operating system unsure what to do with it. The good news: PKPASS (Apple Wallet) is a well-understood format with mature tooling on every major platform. It is supported in one click by mainstream archivers on Windows, macOS, and Linux.

How to extract a PKPASS (Apple Wallet) file

Opening a .pkpass file is straightforward on every modern operating system. The exact steps depend on which platform you are on:

On Windows

Locate the .pkpass file in File Explorer.
Right-click the file. If you have 7-Zip installed, choose 7-Zip → Extract Here. On Windows 11 the built-in extractor handles ZIP, 7z, RAR and several other formats directly through Extract All…
If prompted, pick a destination folder and click Extract.
The extracted files appear in a folder next to the original archive.

On macOS

Find the .pkpass file in Finder.
Install The Unarchiver from the Mac App Store, or Keka for both creating and extracting.
Right-click the file → Open With → The Unarchiver (or just double-click after Unarchiver is set as the default).
The extracted folder appears next to the archive.

On Linux

Use your file manager: right-click the archive → Extract Here (file-roller on GNOME, Ark on KDE).

On the command line, run one of:

7z x archive.pkpass    # works for almost any format

The files appear in the current directory.

How to create a PKPASS (Apple Wallet) file

To pack files into a .pkpass archive, you typically need an archiver that supports writing this format. Not every tool can create every format — for example, only WinRAR can create real RAR files. The sidebar lists the software known to read and write PKPASS (Apple Wallet).

On the command line, the canonical create command is:

# Use 7-Zip, PeaZip, or the format's reference tool to create .pkpass files.

If you regularly create archives at scale, a dedicated archive automation suite can wrap this command in scheduled jobs, integrity checks, and offsite replication.

Strengths

Signed
Standard ZIP underneath
Easy to author

Weaknesses and limitations

Requires Apple developer signing
Apple ecosystem-specific

Typical use cases

Boarding passes
Event tickets
Loyalty cards
Coupons

Technical details

PKPASS (Apple Wallet) uses the ZIP + JSON + signature algorithm and is identified on disk by the magic byte sequence 50 4B 03 04. The standard MIME type is application/vnd.apple.pkpass. The format is an open specification and is free for any use.

Frequently asked questions

Is PKPASS (Apple Wallet) safe to open?

Archive files are containers — they are only as safe as what they contain. A .pkpass from a trusted source is fine; one received from a stranger can hold malicious executables, scripts, or files engineered to exploit bugs in your archiver. Always keep your archiver updated, and never run unknown executables that come out of an archive. A safe workflow is to extract into a sandbox and scan the contents before opening anything.

What is the maximum file size?

Modern ZIP-based formats use the ZIP64 extension to support archives larger than 4 GB and individual files larger than 4 GB, up to 16 EB in theory. Older tooling that does not understand ZIP64 will report a corruption error on such files.

Can I password-protect a PKPASS (Apple Wallet)?

Some archivers can wrap PKPASS (Apple Wallet) files in an encrypted container, but the format itself does not always include built-in encryption. Check your archiver's documentation.

How does PKPASS (Apple Wallet) compare to other formats?

See our format comparison pages such as ZIP vs 7z, ZIP vs RAR, and tar.gz vs tar.xz for side-by-side feature tables.