Add to Apple Wallet badge guidelines

The Add to Apple Wallet badge give people a visual cue to add passes, tickets, coupons, and more to the Wallet app on their Apple device. Follow these guidelines when using the badge on your web pages, email, and printed materials.

Using the badge

The Add to Apple Wallet badge is designed to be used on web pages and emails, or printed materials accompanied by a QR code that lets people add a pass to Apple Wallet. The badge should appear only in association with your Wallet‑compatible pass.

For apps, use the PKAddPassButton class to create an Add to Apple Wallet button. You can choose the button’s style, and the system provides a control with the correct appearance and language. It’s available as a one-line button or two-line button.

Download badge files

Format

The Add to Apple Wallet badge is available in 45 locales in SVG and EPS file formats.

  • Be sure to use the badges provided by Apple. Do not create your own versions.
  • Use the SVG artwork provided by Apple for badges on your web pages and email.
  • Use the EPS artwork for badges on printed materials accompanied by a QR code.

Localized badge

Background color

Use this badge on white or light-colored backgrounds that provide sufficient contrast. With very dark backgrounds, use the outline option shown.

Clear space

For onscreen layouts, the minimum clear space for the badge is .1X where X is the height of the badge. For print, see Printing the badge with a code.

Email

Place the badge near the pass that can be stored in Wallet. Users can add their pass to Wallet directly from email opened on their iPhone, iPod touch, or Mac. Because users might open the email on another device, include instructions for opening the email on iPhone, iPod touch, or Mac.

Web pages

Place the badge near the pass that can be stored in Wallet. Users can add their pass to Wallet directly from a web page opened on iPhone, iPod touch, or Mac. Because users might open the web page on another device, include instructions for opening the page on their iPhone, iPod touch, or Mac.

Using the badge on printed materials

In printed materials, the Add to Apple Wallet badge should appear only in association with a Wallet-compatible pass and must be accompanied by a QR code or bar code. Customers can use the Camera app to scan the code on point-of-sale signage, coupons, posters, or other printed material. Scanning the code adds the pass to Wallet.

Point-of-sale sign

Place the Add to Apple Wallet badge and suggested messaging near the code. Place the badge on the layout so that it is clearly visible yet in a subordinate position following the main graphics and messages.

Poster

On large printed materials, the Add to Apple Wallet badge cannot be larger than the maximum height requirement of 25 mm.

Printing the badge with a code

Clear space and size requirements

Minimum clear space is one-quarter the height of the badge. On printed materials, the minimum size for the Add to Apple Wallet badge is 10 mm in height and the maximum size is 25 mm in height. Do not reduce or enlarge the badge beyond these sizes.

QR codes and bar codes

A recommended minimum code size for optimum scanning to Wallet is 40 mm wide. At this size QR codes of version 10 or lower, PDF 417 bar codes with five or fewer data columns, and Aztec codes of six or fewer data layers are recommended.

Badge and code alignment

It is recommended that the code and Add to Apple Wallet badge be aligned to equal width. It is also acceptable to have the codes left or center aligned.

White space

Allow minimum clear space around the Add to Apple Wallet badge. Make sure you also comply with the requirements for a surrounding “quiet zone” for the type of code you are using. Codes must be printed on a white or light background. If your layout includes a dark background, do not extend the code’s required surrounding white space to include the Add to Apple Wallet badge. The white space should surround only the code. On dark backgrounds, the Add to Apple Wallet badge should not touch the code’s required surrounding white space.

Editorial guidelines

Messaging that describes Wallet can be used in communications promoting Wallet-compatible passes. Messaging can be placed near the Add to Apple Wallet badge that accompanies your pass, or it can be used in general product communications to describe compatibility with Wallet.

Suggested messaging

You can use the suggested messaging below to describe and promote Wallet, or you can develop your own copy. Always follow the guidelines for using the name Wallet described below.

  • Wallet description—long version:

    “The Wallet app on Apple Watch, iPhone, and iPod touch is where you store and access all your boarding passes, movie tickets, coupons, rewards cards, and more.”

  • Wallet description—short version:

    “Wallet is where you store and access all your boarding passes, movie tickets, retail coupons, rewards cards, and more.”

  • Instructions for adding a pass to Wallet if opened on a device other than iPhone or iPod touch:

    “To add this [pass/ticket/coupon/card] to Wallet, open this [email, web page] on your iPhone or iPod touch.”

  • Instructions for scanning a code—for use on printed materials:

    “Wallet on Apple Watch, iPhone, and iPod touch is where you store and access all your boarding passes, movie tickets, retail coupons, rewards cards, and more. You can scan this code to have a [insert brand/type of pass here] appear right in Wallet. To scan, just open the Camera app on your iPhone and point it at the code.”

Using the name Wallet or Apple Wallet

When using the app name Wallet or Apple Wallet in headlines or copy, always typeset Wallet with an uppercase W followed by lowercase letters. Typeset Apple with an uppercase A followed by lowercase letters. Apple Wallet is set as two words.

If a headline is typeset all uppercase, the words Apple Wallet within the headline can also be uppercase.

You can refer to the Wallet app from Apple or Apple Wallet on the first mention of the app. In subsequent references, just Wallet can be used.

In U.S. communications, use the registered trademark symbol (®) the first time Apple appears in body copy.

Avoid mistakes

Only the Apple-provided badges shown in these guidelines are approved by Apple.

  • Do not let the Add to Apple Wallet badge dominate your layout as the primary message or main graphic. It must be secondary to your main message and product or company identity.
  • Do not create your own version of the Add to Apple Wallet badge.
  • Do not obstruct the badge with text, graphics, images, or other elements.
  • Do not display a dimmed version of the badge to indicate that it has not been selected.
  • Do not use the Wallet icon alone.
  • Do not flip, rotate, or animate the artwork.
  • Do not add visual effects such as shadows, glows, or reflections to the mark.
  • Do not use graphics or images from Apple’s website.
  • Do not imitate Apple communications.