--- title: "Split Views" platform: universal category: layout url: https://developer.apple.com/design/human-interface-guidelines/split-views id: split-views lastUpdated: 2025-07-01T00:51:33.199Z extractionMethod: enhanced-turndown qualityScore: 0.800 confidence: 1.000 contentLength: 6633 structureScore: 0.500 cleaningScore: 0.109 hasCodeExamples: false hasImages: false keywords: ["june", "2025", "added", "ios", "ipados", "platform", "considerations", "split", "views", "view"] --- ## Overview June 9, 2025 Added iOS and iPadOS platform considerations. Split views A split view manages the presentation of multiple adjacent panes of content, each of which can contain a variety of components, including tables, collections, images, and custom views. Typically, you use a split view to show multiple levels of your app’s hierarchy at once and support navigation between them. In this scenario, selecting an item in the view’s primary pane displays the item’s contents in the secondary pane. Similarly, a split view can display a tertiary pane if items in the secondary pane contain additional content. It’s common to use a split view to display a sidebar for navigation, where the leading pane lists the top-level items or collections in an app, and the secondary and optional tertiary panes can present child collections and item details. Rarely, you might also use a split view to provide groups of functionality that supplement the primary view — for example, Keynote in macOS uses split view panes to present the slide navigator, the presenter notes, and the inspector pane in areas that surround the main slide canvas. Best practices To support navigation, persistently highlight the current selection in each pane that leads to the detail view. The selected appearance clarifies the relationship between the content in various panes and helps people stay oriented. Consider letting people drag and drop content between panes. Because a split view provides access to multiple levels of hierarchy, people can conveniently move content from one part of your app to another by dragging items to different panes. For guidance, see Drag and drop. Platform considerations iOS Prefer using a split view in a regular — not a compact — environment. A split view needs horizontal space in which to display multiple panes. In a compact environment, such as iPhone in portrait orientation, it’s difficult to display multiple panes without wrapping or truncating the content, making it less legible and harder to interact with. iPadOS In iPadOS, a split view can include either two vertical panes, like Mail, or three vertical panes, like Keynote. Account for narrow, compact, and intermediate window widths. Since iPad windows are fluidly resizable, it’s important to consider the design of a split view layout at multiple widths. In particular, ensure that it’s possible to navigate between the various panes in a logical way. For guidance, see Layout. For developer guidance, see NavigationSplitView and UISplitViewController. macOS In macOS, you can arrange the panes of a split view horizontally, vertically, or both. A split view includes dividers between panes that can support dragging to resize them. For developer guidance, see HSplitView and VSplitView. Set reasonable defaults for minimum and maximum pane sizes. If people can resize the panes in your app’s split view, make sure to use sizes that keep the divider visible. If a pane gets too small, the divider can seem to disappear, becoming difficult to use. Consider letting people hide a pane when it makes sense. If your app includes an editing area, for example, consider letting people hide other panes to reduce distractions or allow more room for editing — in Keynote, people can hide the navigator and presenter notes panes when they want to edit slide content. Provide multiple ways to reveal hidden panes. For example, you might provide a toolbar button or a menu command — including a keyboard shortcut — that people can use to restore a hidden pane. Prefer the thin divider style. The thin divider measures one point in width, giving you maximum space for content while remaining easy for people to use. Avoid using thicker divider styles unless you have a specific need. For example, if both sides of a divider present table rows that use strong linear elements that might make a thin divider hard to distinguish, it might work to use a thicker divider. For developer guidance, see NSSplitView.DividerStyle. tvOS In tvOS, a split view can work well to help people filter content. When people choose a filter category in the primary pane, your app can display the results in the secondary pane. Choose a split view layout that keeps the panes looking balanced. By default, a split view devotes a third of the screen width to the primary pane and two-thirds to the secondary pane, but you can also specify a half-and-half layout. Display a single title above a split view, helping people understand the content as a whole. People already know how to use a split view to navigate and filter content; they don’t need titles that describe what each pane contains. Choose the title’s alignment based on the type of content the secondary pane contains. Specifically, when the secondary pane contains a content collection, consider centering the title in the window. In contrast, if the secondary pane contains a single main view of important content, consider placing the title above the primary view to give the content more room. visionOS Prefer a split view — not a new window — for offering supplementary information. A split view gives people convenient access to more information without leaving the current context. Opening new windows to show details related to the current window makes it hard to understand relationships and manage window placement. If you need to request a small amount of information or present a simple task that someone must complete before returning to their main task, consider using a sheet. watchOS In watchOS, the split view displays either the list view or a detail view as a full-screen view. Automatically display the most relevant detail view. When your app launches, show people the most pertinent information. For example, display information relevant to their location, the time, or their recent actions. If your app displays multiple detail pages, place the detail views in a vertical tab view. People can then use the Digital Crown to scroll between the detail view’s tabs. watchOS also displays a page indicator next to the Digital Crown, indicating the number of tabs and the currently selected tab. Resources Related Sidebars Tab bars Layout Developer documentation NavigationSplitView — SwiftUI UISplitViewController — UIKit NSSplitViewController — AppKit Videos Make your UIKit app more flexible Change log Date Changes June 9, 2025 Added iOS and iPadOS platform considerations. December 5, 2023 Added guidance for split views in visionOS. June 5, 2023 Added guidance for split views in watchOS. Current page is Split views Supported platforms Split views Best practices Platform considerations Resources Change log ## Related Concepts - toolbar - button - tab bars - layout --- **Attribution Notice** This content is sourced from Apple's Human Interface Guidelines: https://developer.apple.com/design/human-interface-guidelines/split-views This content was successfully extracted and structured from Apple's official documentation. © Apple Inc. All rights reserved. This content is provided for educational and development purposes under fair use. This MCP server is not affiliated with Apple Inc. and does not claim ownership of Apple's content. For the most up-to-date and official information, please refer to Apple's official documentation.