Split views

On this page2 sections

Best practices

To support navigation, persistently highlight the current selection in each pane that leads to the detail view.

Consider letting people drag and drop content between panes.

Platform considerations

iOS

Prefer using a split view in a regular — not a compact — environment.

iPadOS

Account for narrow, compact, and intermediate window widths.

macOS

  • Vertical
  • Horizontal
  • Multiple

Set reasonable defaults for minimum and maximum pane sizes.

Consider letting people hide a pane when it makes sense.

Provide multiple ways to reveal hidden panes.

Prefer the thin divider style.

tvOS

Choose a split view layout that keeps the panes looking balanced.

Display a single title above a split view, helping people understand the content as a whole.

Choose the title’s alignment based on the type of content the secondary pane contains.

visionOS

To display supplementary information, prefer a split view instead of a new window.

watchOS

Automatically display the most relevant detail view.

If your app displays multiple detail pages, place the detail views in a verticaltab view.


For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/split-views

Apple HIG text and imagery are © Apple Inc. This page is a structured index of Apple’s canonical documentation (snapshot 2025-02-02), provided for quick reference and AI-agent consumption — it isn’t affiliated with or endorsed by Apple. Read the original at developer.apple.com (opens in new tab).

Get HIG guidance in your AI

Install HIG Doctor and get expert Apple design guidance directly in Claude Code.

npx skills add raintree-technology/hig-doctor
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.