Home Screen Quick Actions

Home screen quick actions are a convenient way to perform useful, app-specific actions right from the Home screen. People can get a menu of available quick actions when they touch and hold an app icon (on a 3D Touch device, people can press briefly on the icon to see the menu). For example, Mail includes quick actions that open the Inbox or the VIP mailbox, initiate a search, and create a new message. In addition to app-specific actions, a Home screen quick action menu also lists items for removing the app and editing the Home screen.

Each Home screen quick action includes a title, a glyph on the left or right (depending on your app’s position on the Home screen), and an optional subtitle. The title and subtitle are always left-aligned in left-to-right languages. Your app can even dynamically update its quick actions when new information is available. For example, Messages provides quick actions for opening your most recent conversations.

Screenshot of the Mail app's list of Home screen quick action menu, which lists from the top New Message, Search, V I P (No Unread Messages), and Inbox (18 Unread Messages. Below the quick actions are listed two items, which are Edit Home Screen and Remove App.

Create quick actions for compelling, high-value tasks. For example, Maps lets people search near their current location or get directions home without first opening the Maps app. Every app should enable at least one useful quick action; you can provide a total of four.

Avoid using quick actions to ease navigation. If it’s difficult or time-consuming to visit important areas in your app, first fix your navigation to work well for everyone. Next, focus on providing quick actions that enable useful, creative tasks.

Avoid making unpredictable changes to quick actions. Dynamic quick actions are a great way to keep actions relevant. For example, it may make sense to update quick actions based on the current location or recent activities in your app, time of day, or changes in settings. However, actions shouldn’t change in ways that are unpredictable or confusing.

Provide a succinct title for each quick action. An action’s title should instantly communicate the results of the action; for example, “Directions Home,” “Create New Contact,” and “New Message.” If you need to give more context, provide a subtitle too. Mail uses subtitles to indicate whether there are unread messages in the Inbox and VIP folder. Don’t include your app name or any extraneous information in the title or subtitle, keep the text short to avoid truncation, and take localization into account as you write the text.

Don’t use quick actions for notification. People expect to receive notifications from apps in other ways. See Notifications.

Provide a recognizable glyph for each quick action. Consider using an SF symbol to represent each action (for guidance, see SF Symbols). Alternatively, you can use the familiar system glyphs listed in Quick Action Icons. If you design your own glyphs, use the Quick Action Icon Template that’s included with Apple Design Resources for iOS and use the following sizes for guidance.

Image of a solid blue square, which represents the maximum size, with the outline of a smaller square centered inside it. A vertical line, extending to the top and bottom edges of the outer square, represents the maximum height. A horizontal line, extending to the left and right edges of the outer square, represents the maximum width.

Maximum width and height
34.67x34.67 pt (104x104 px @3x)
35x35 pt (70x70 px @2x)

Image of a solid blue square, which represents the target, centered inside a larger, white square. A vertical line, extending to the top and bottom edges of the inner square, represents the target’s height. A horizontal line, extending to left and right edges of the inner square, represents the target’s width.

Target width and height
26.67x26.67 pt (80x80 px @3x)
27x27 pt (54x54 px @2x)

Image of a solid blue rectangle, which represents the target, inside the outline of a larger square. The width of the rectangle is slightly larger than its height. A horizontal line, extending to the left and right edges of the rectangle, indicates the target’s width.

Target width (wide glyphs)
29.33pt (88px @3x)
30pt (60px @2x)

Image of a solid blue rectangle, which represents the target, inside the outline of a larger square. The height of the rectangle is slightly larger than its width. A vertical line, extending to the top and bottom edges of the rectangle, indicates the target’s height.

Target height (tall glyphs)
29.33pt (88px @3x)
30pt (60px @2x)

Don’t use an emoji in place of a glyph. Emojis don’t align properly with right-aligned text. Also, emojis are full color, whereas quick action glyphs are monochromatic.