Change history

38 versions since · checked every 4 hours · developer.apple.com/design/human-interface-guidelines/

Show
Version Date Level Changes
v38 Minor

Developer guidance link renamed to "Creating custom SF Symbols" on symbol-related pages

  • Minor 3 sections
v36–v37 No net change

Pages missing from one check, then back (no net change).

v35 Not assessed

Adds guidance for touch input on Macs with a touch display across macOS pages

  • Not assessed 18 sections
v34 No net change

Pages missing from one check; v35 is compared with v33.

v32–v33 No net change

Pages missing from one check, then back (no net change).

v31 Cosmetic

Grammar fix in iOS best practices: adds missing "to" in a sentence about swipe gestures

v30 Not assessed

Widget guidance adds Apple HomeView section covering the Modular face and Home Screen

  • Not assessed 18 sections
v28–v29 No net change

Pages missing from one check, then back (no net change).

v27 Cosmetic

SF Symbols resources list drops "UIKit" label from custom symbols link

  • Cosmetic SF Symbols › Resources: In the SF Symbols Resources section, the "Creating custom symbols" developer documentation link no longer carries the "— UIKit" framework label.
v26 Minor

Developer guidance link renamed to "Creating custom symbols" in SF Symbols pages

  • Minor 3 sections
v25 Minor

macOS document icon guidance drops the Apple Design Resources template mention

  • Minor Platform considerations › macOS: The macOS document icons section no longer mentions the Apple Design Resources template for creating a background fill and center image; the design guidelines themselves are unchanged.
v24 Notable

iPhone Duo device poses guidance no longer names Xcode 27.1 for Device Hub

  • Notable Anatomy › Device poses: The iPhone Duo device poses section now says to use Device Hub in Xcode to preview apps, removing the reference to Xcode 27.1.
v23 Notable

In-app purchase renamed Apple In-App Purchase; subscription retention guidance revised

v22 Major proposed

Privacy pages now allow legal consent screens around App Tracking Transparency alerts

  • Major Requesting permission › Pre-alert screens, windows, or views: Pre-alert permission screens may now include additional actions when needed to obtain a legal consent; otherwise the single-button rule still applies.
  • Major Requesting permission › Tracking requests: Tracking requests guidance now states that a consent screen shown before or after the App Tracking Transparency alert to comply with local privacy laws is allowed.
  • Notable Designing for iPhone Duo: The iPhone Duo design page adds a pointer to the developer article "Preparing your app for iPhone Duo".
  • Notable Anatomy › Device poses: The Device poses section adds that developers can use Device Hub in Xcode 27.1 to preview apps on iPhone Duo and test how they appear in its poses.
  • Notable Designing for iPhone Duo › Resources: The previous Resources list on the iPhone Duo page, without developer documentation links, is removed and replaced by an expanded list.
  • Notable Designing for iPhone Duo › Resources: The iPhone Duo Resources list adds a Developer documentation group linking the preparation article, ReservedRegion, UIView.ReservedRegion, ArrangementView and UIArrangementViewController.
  • Minor 4 other sections
v21 Not assessed

New Designing for iPhone Duo page adds guidance for dual displays, poses and side controls

  • Not assessed 45 sections
v20 Minor

Wallet generic passes developer guidance link now titled "Creating a poster generic pass"

  • Minor Pass styles › Generic passes: In the Wallet generic passes section, the referenced developer guidance changed from "Creating a generic pass" to "Creating a poster generic pass".
v18–v19 No net change

Pages missing from one check, then back (no net change).

v16–v17 No net change

Pages missing from one check, then back (no net change).

v14–v15 No net change

Pages missing from one check, then back (no net change).

v13 Cosmetic

No wording changed; only formatting or link targets

No wording changed; only formatting or link targets

v11–v12 No net change

Pages missing from one check, then back (no net change).

v10 Minor

App icons guidance points to Parallax Previewer and Exporter plug-in

  • Minor 3 sections
v9 Cosmetic

The text matches v7 again (). The changes recorded in v8 () are no longer there.

v8 Cosmetic

No wording changed; only formatting or link targets

No wording changed; only formatting or link targets

v7 Minor

Resource sections updated: Videos headings added or removed, MusicKit link added

  • Minor 4 sections
v6 Not assessed
  • Not assessed 155 sections
v5 Cosmetic

Segmented controls page updates the developer guidance reference for momentary tracking

  • Cosmetic Segmented controls: The developer guidance reference on the Segmented controls page now shows the readable name NSSegmentedControl.SwitchTracking.momentary in place of a raw documentation URL.
v4 Not assessed

Adds Look to Scroll guidance for visionOS and revises sheet button guidance

  • Not assessed 14 sections
v3 Minor

The text matches v1 again (). The changes recorded in v2 () are no longer there.

v2 Minor

Accessibility page adds a paragraph labeled as being for testing purposes

  • Minor 2 sections

Proposed: the level shown waits for the site owner's review.

Summaries are written automatically and may be wrong; each version's diff is the record.

Sections changed most often (last 24 months)

SectionVersions
SF Symbols › Resources3
App icons › Layer design3
Anatomy › Device poses3
Pass styles › Generic passes3
Right to left › Interface icons2