Buttons

Apple provides several Sign in with Apple buttons you can use to let people set up an account and sign in. If necessary, you can create a custom button to offer Sign in with Apple; for guidelines, see Creating a Custom Sign in with Apple Button.

Prominently display a Sign in with Apple button. Make a Sign in with Apple button no smaller than other sign-in buttons, and avoid making people scroll to see the button.

Using the System-Provided Buttons

When you use the system-provided APIs to create a Sign in with Apple button, you get the following advantages.

  • A button that's guaranteed to use an Apple-approved title, font, color, and style
  • Assurance that the button's contents maintain ideal proportions as you change its style
  • Automatic translation of the button's title into the language specified by the device
  • Support for configuring the button's corner radius to match the style of your UI (iOS, macOS, and web)
  • A system-provided alternative text label that lets VoiceOver describe the button

For developer guidance, see ASAuthorizationAppleIDButton (iOS, macOS, and tvOS), WKInterfaceAuthorizationAppleIDButton (watchOS), and Displaying and Configuring Sign in with Apple Buttons (web). You can also visit Sign in with Apple Button to view and adjust live previews of web-based buttons and get the code.

The system provides several variants of the button title. Depending on the platform on which your content runs, choose the variant that fits the terminology of your sign-in experience and use it consistently throughout your interfaces.

The following button titles are available for iOS, macOS, tvOS, and the web:

Image of a black button that displays the Apple logo followed by Sign in with Apple.

Image of a black button that displays the Apple logo followed by Sign up with Apple.

Image of a black button that displays the Apple logo followed by Continue with Apple.

For watchOS, the system provides one title:  Sign in.

Image of a watchOS. button that displays the Apple logo followed by Sign in.

Depending on the platform, the system provides up to three options for the appearance of the Sign in with Apple button: white, white with an outline, and black. Choose the appearance that works best with the background on which the button displays.

White

The white style is available on all platforms and the web. Use this style on dark or colored backgrounds that provide sufficient contrast.

A white Sign in with Apple button over a dark green background.

White check in a green circle to indicate correct usage.

A white Sign in with Apple button over a light gray background.

White X in a gray circle to indicate incorrect usage.

White with Outline

The white outlined style is available in iOS, macOS, and the web. Use this style on white or light-colored backgrounds that don’t provide sufficient contrast with the white button fill. Avoid using this style on a dark or saturated background, because the black outline can add visual clutter; instead, use the white style to contrast with a dark background.

A white, outlined Sign in with Apple button over a light gray background.

White check in a green circle to indicate correct usage.

A white, outlined Sign in with Apple button over a dark green background.

White X in a gray circle to indicate incorrect usage.

Black

The black style is available on all platforms and the web. Use this style on white or light-colored backgrounds that provide sufficient contrast; don't use it on black or dark backgrounds.

A black Sign in with Apple button over a light gray background.

White check in a green circle to indicate correct usage.

A black Sign in with Apple button over a dark green background.

White X in a gray circle to indicate incorrect usage.

Unlike the black Sign in with Apple button for other platforms, the watchOS button uses a fill color that's not fully black. To contrast with the pure black background of Apple Watch, the watchOS button uses the system-defined dark gray appearance.

A dark gray watchOS Sign in button on top of a black background.

Button Size and Corner Radius

Adjust the corner radius to match the appearance of other buttons in your app. By default, the Sign in with Apple button has rounded corners. In iOS, macOS, and the web, you can change the corner radius to produce a button with square corners or a pill-shaped button. For developer guidance, see cornerRadius (iOS and macOS) and Displaying and Configuring Sign in with Apple Buttons (web).

A black Sign in with Apple button that uses ninety degree corners.

Minimum corner radius

A black Sign in with Apple button that uses the default corner radius.

Default corner radius

A black Sign in with Apple button that uses the maximum corner radius, which results in a lozenge-like appearance.

Maximum corner radius

Maintain the minimum button size and margin around the button in iOS, macOS, and the web. Be mindful that the button title may vary in length depending on the locale. Use the following values for guidance.

Minimum width Minimum height Minimum margin
140pt (140px @1x, 280px @2x) 30pt (30px @1x, 60px @2x) 1/10 of the button's height

Creating a Custom Sign in with Apple Button

If your layout requires it, you can create a custom Sign in with Apple button for iOS, macOS, or the web. For example, if you support multiple sign-in methods, you may want to display sign-in buttons that use left-aligned logos, or that display a logo only.

Diagram that displays two sign-in screens. The screen on the left displays text inviting people to sign in for a personalized experience. Below the text, the screen displays a black Sign in with Apple button in which the Apple logo is left aligned. Below the Sign in with Apple button, the screen displays a stack of three additional sign-in buttons, each of which uses a generic shape, like a circle or star, to represent a different corporate logo. In all four buttons, the logos are left-aligned and the button titles are also aligned. The righthand screen displays empty email address and password fields above a button titled Create Account. Below the button, the screen displays the text Or sign in with, followed by a row of three logo-only buttons. The leftmost button is a logo-only Sign in with Apple button, the other two buttons use generic shapes to represent other corporate logos.

Apple Design Resources provides downloadable Apple logo artwork you can use to create custom left-aligned or logo-only Sign in with Apple buttons. The logo files are available in PNG, SVG, and PDF formats, and the artwork for both types of buttons provides two appearances. Here are examples of the black and white logo-only art files, each with a background added for visibility.

Image of the black logo-only asset.

Image of the white logo-only asset.

All downloadable logo files include padding that makes it easy to position the logo in a button:

  • Left-aligned logo files include vertical padding that ensures the correct proportion of the logo relative to the button, and horizontal padding that provides a minimum margin between the logo and the button’s left edge and title.
  • Logo-only logo files include horizontal and vertical padding that ensures the correct proportion of the logo relative to the button.

Use only the logo artwork downloaded from Apple Design Resources. Follow these guidelines to create and position the downloadable logo files:

  • Use the logo file to position the Apple logo in a button; never use the Apple logo as a button.
  • Match the height of the logo file to the height of the button.
  • Don't crop the logo file.
  • Don't add vertical padding.
  • Don't use a custom color in a logo file.

Left-Aligned Logo Buttons

Choose the format of the logo file based on the height of your button. Because SVG and PDF are vector-based formats, you can use these files in buttons of any height. Use the PNG files only in buttons that are 44 points tall, which is the default (and recommended) button height in iOS. Also, the left-aligned logos are available in small, medium, and large sizes, so you can match logo sizes in all the sign-up buttons you display.

Use the system font for the title — that is, Sign in with Apple, Sign up with Apple, or Continue with Apple. To look correct, the title and button height of your custom button should use the same proportions that the system uses. Specifically, the title's font size should be 43% of the button's height — in other words, the button's height should be 233% of the title's font size, rounded to the nearest integer. Here are two examples that illustrate these proportions.

A black Sign in with Apple button with callouts that indicate a button height of 44 points and a font size of 19 points.

A black Sign in with Apple button with callouts that indicate a button height of 56 points and a font size of 24 points.

Preserve the capitalization style of the title. All variants of the button title capitalize the first word — that is, Sign or Continue — and Apple; all other letters are lowercase. Don't change this style by, for example, capitalizing every letter in the title.

Keep the title and logo vertically aligned within the button. To do this, vertically align the title to the middle of the button, then add the logo image, making sure its height matches the height of the button. Because the logo image includes top and bottom padding, vertically aligning the title in the button ensures that the title, the logo, and the button stay properly aligned.

Inset the logo if necessary. If you need to horizontally align the Apple logo with other authentication logos, you can inset the left side of the logo.

Maintain a minimum margin between the title and the right edge of the button. The margin should measure at least 8% of the button's width.

Maintain the minimum button size and margin around the button. Be mindful that the button title may vary in length depending on the locale. Use the following values for guidance.

Minimum width Minimum height Minimum margin
140pt (140px @1x, 280px @2x) 30pt (30px @1x, 60px @2x) 1/10 of the button's height

Logo-Only Buttons

Choose the format of the logo file based on the size of your button. As with the artwork for left-aligned logo buttons, the downloadable artwork for logo-only buttons is available in SVG, PDF, and PNG formats. Use the vector-based SVG and PDF formats for buttons of any size; use the PNG format only in buttons that measure 44pt × 44pt.

Don't add horizontal padding to a logo-only image. A logo-only Sign in with Apple button always has a 1:1 aspect ratio, and the artwork already includes the correct padding on all sides.

Use a mask to change the default square shape of the logo-only image. For example, you might want to use a circular or rounded rectangular shape to present all logo-only sign-in buttons. Never crop the Apple-provided artwork to decrease its built-in padding or use the logo by itself, and avoid including additional padding.

A black logo-only Sign in with Apple button, masked to use rounded rectangular corners.

Rounded rectangle mask

A black logo-only Sign in with Apple button that uses the default 90 degree corner radius.

No mask

A black logo-only Sign in with Apple button, masked to use a circular shape.

Circular mask

Maintain a minimum margin around the button. The margin should measure at least 1/10 of the button's height.