Text

Do

Use to help group text and items in a logical order.

Don't

Use to emphasize text that you want users to read. Instead, use bold body text or another UI element like a banner or popover.

Do

Keep headings and titles short and glanceable.

Don't

Use overly long headings. If headings are dynamically generated (like a 3rd party app name), truncation will work after 2 lines, but be mindful of unintended changes in meaning.

Do

Clearly describe the section a heading refers to.

Don't

Use vague language that doesn’t describe the section that a heading refers to.

Do

Emphasize text inside of paragraphs by using a bold weight.

Don't

Emphasize text inside of paragraphs by underlining it; this can be confused with an interactive link or a button.

Do

Use a minimal amount of sizes and styles to keep the UI clean and readable.

Don't

Mix styles and alignment, as this can be hard to read and follow.

Do

Start-align paragraph text.

Don't

Center-align or end-align paragraph text. This is hard to read, especially for users with dyslexia.

A minimum text size of 16pt is recommended for readability, especially for longer blocks of text. Some short text labels or secondary text can go lower than that, but smaller sizes should be kept to a minimum. Making text brief will also help with readability.

As users scale text with Accessibility settings, sizes should scale according to iOS defaults. Our text sizes when Accessibility settings are turned on are below.

People use Apple’s accessibility features, such as reduced transparency, VoiceOver, and increased text size, to personalize how they interact with their devices. Supporting these personalizations ensures that everyone has a great user experience. See Apple’s Human Interface Guidelines and documentation about accessibility for iOS:

Accessible design on iOS

Use these tokens for applying size, weight and color styles to Text.

Used for surface titles and section headings

Used for text that is part of paragraphs or UI controls

These font sizes follow those available through our Typography scale

This is how text scales when people resize text. Our default text sizes correspond to iOS Large sizes. For more info, see iOS Dynamic Type sizes

For emphasizing text in body copy and in sizes below 16pt and below, use bold. For titles and headings, use semibold.

Text can either be start, center or end aligned. Text can be forced to left or right align when aligning integers in tables.

You can specify which color you want for your text. Most colors automatically change between light and dark modes, but the light and dark properties are available when light or dark colors are specifically desired. An example is using the dark mode error color on a dark background in light mode.

Text can be italicized for emphasis, or underlined to denote a link.

For general guidelines around text truncation, see Typography Best practices

Keep text simple and short to avoid truncation or line-wrapping in UI controls like buttons when translating languages that require more characters. Avoid overriding our line-height settings, as this can result in text clipping for scripts, like Hindi, that have taller ascenders and descenders.

When translated to languages that read from right to left, ensure that paragraph text is aligned based on language not on context. For example, if the UI is reversed for an RTL language like Arabic, but there is a block of text in an LTR language such as English, left-align the paragraph in English.

Do

Don't

However, for lists or items in a menu, maintain the alignment of the UI.

Do

Don't

Hyphenation on iOS is turned off by default to avoid incorrect word breaks when strings of text wrap to the next line. This is especially helpful for international languages where an incorrect word break can greatly change the meaning of a word or sentence.

Typography guidelines

A run-down of our typographic foundations across platforms