DuoApps

What compresses first on iPhone Duo: the toolbar or the tab bar

On iPhone Duo, the toolbar and the tab bar share one column on the side. When space runs short, one of them compresses first. By default, it’s the toolbar: its items move into the overflow menu, from the bottom up, and the tab bar stays whole. On a screen where people finish a task, the app can ask for the opposite: the tab bar shrinks to a single control, and the actions stay. Then give items a priority: frequently used actions and items with badges leave last.

RecommendationLast checked October 12, 2026

The problem

The outer display in landscape: on a screen people browse, the toolbar compresses and the tab bar stays; on a screen where people finish a task, the tab bar collapses to a single control and the actions stay.

On the side, the toolbar, the tab bar, and navigation buttons share a single column with the status bar and the Dynamic Island (Where the bars go). That column isn’t always the same height. It’s shorter on the outer display in landscape, and it loses more room when the Dynamic Island grows for Live Activities, or when the keyboard opens.

When everything no longer fits, the system makes one bar give way: either the toolbar’s items move into the overflow menu, or the tab bar shrinks. By default, the toolbar gives way. On a screen where people finish a task, the very actions they need then end up behind the three dots.

The rules

  1. 1

    Plan for some of your controls to leave the bar. On the side, they share the height with the status bar and with the Dynamic Island, which grows when Live Activities arrive. Space runs short more often on the outer display in landscape, simply because there’s less height, and also when other interface elements appear, like the keyboard, or Picture in Picture when the device is open in portrait. The system then moves controls into the overflow menu on its own.

    AppleHIG, Vertical controls · “Design for iPhone Duo”, 1:34 · “Design for iPhone Duo”, 5:36 · “Raise the bar”, 11:39

  2. 2

    Choose, screen by screen, which stays visible longer: the toolbar or the tab bar. On a screen people browse (a navigation-focused experience, in Apple’s words), like a view in Podcasts, the toolbar compresses first: its items move into the overflow menu, and the tab bar stays whole, so the app’s primary destinations remain within reach. That’s the default behavior: nothing to set.

    AppleHIG, Vertical controls · “Raise the bar”, 11:39 · “Raise the bar”, 12:03 · “Raise the bar”, 12:12

  3. 3

    On a screen where people finish a task (a task-oriented experience), like a view in the Games app, have the tab bar compress first. It shrinks to a single control, as the tab bar minimizes on other iPhone models, and the toolbar actions people need to finish the task stay visible. That isn’t the default behavior: the app asks for it on that screen, and the system applies it.

    AppleHIG, Vertical controls · “Raise the bar”, 12:14

  4. 4

    To decide, ask what people come to the screen to do. If they browse and move between destinations, as in a list, a grid, or a block-based home screen, keep the tab bar. If they come to finish something, as in a form, or a cart on its way to checkout, keep the actions and let the tab bar shrink. Apple defines the two experiences and gives one example of each; matching them to screen types is ours, the same split as in the checklist of Don’t stretch.

    RecommendationApple sources: HIG, Vertical controls · “Raise the bar”, 12:03 · “Raise the bar”, 12:14

  5. 5

    Then order the toolbar. When the tab bar keeps its place, or the toolbar needs more room than there is, its items move into the overflow menu one by one: by default, from the bottom up. To change that order, the app gives items a visibility priority, high, low, or custom, first to whole groups, then, if needed, to single items within a group. So group related items instead of spacing them by hand: the system’s groups adapt as the available space changes.

    AppleHIG, Vertical controls · Developer article, Organize items in your bars · “Raise the bar”, 13:09 · “Raise the bar”, 13:23 · “Raise the bar”, 13:36 · “Raise the bar”, 13:40

  6. 6

    Keep the actions people use most visible the longest, like Compose in Mail or New Note in Notes. Keep items that show a status visible longer too, like an item with a badge, so people can see it at a glance.

    AppleHIG, Vertical controls · “Raise the bar”, 13:54

  7. 7

    Have a single overflow menu, the system’s. If your app already has its own, move its actions into the system’s, so people find everything in one place; the app can also put items in it directly. Keep the ellipsis (three dots) for that menu, and give any other menu a symbol of its own. In the overflow menu, the system shows each item with its title and its symbol: give every item a title, even one people only see as a symbol (Symbols, not labels, rule 1).

    AppleHIG, Vertical controls · Developer article, Organize items in your bars · “Raise the bar”, 6:32 · “Raise the bar”, 12:36 · “Raise the bar”, 12:50 · “Raise the bar”, 12:57

  8. 8

    Compressing isn’t removing. An action that leaves the bar stays within reach in the overflow menu. From one pose to the next, give access to the same controls and the same content, however people hold the device.

    AppleHIG, Best practices · “Design for iPhone Duo”, 5:03

Demo

One generic app, closed, in portrait, on two screens with the same tab bar: on the left, a list people browse; on the right, an editor where they finish a task. Push the slider: the Dynamic Island grows, as it does when Live Activities arrive, and the column gets shorter. Landscape and the keyboard shorten it too.
Static version, no JavaScript
  1. 9:41
    9:41

    A list people browse

    9:41
    9:41

    An editor: a task to finish

    At rest. Everything fits: on both screens, every toolbar item is on the side, above a whole tab bar. On the list: New, Filter, Save, Comments with a badge, and Share. On the editor: Back, Done, Format, Share, and Delete.

  2. 9:41
    9:41

    A list people browse

    9:41
    9:41

    An editor: a task to finish

    Less room. On the list, the toolbar gives way and the tab bar stays whole: Share and Save move into the overflow menu (rule 2). Comments stays, though it sits lower than Save: its badge gives it a high priority (rules 5 and 6). On the editor, the tab bar gives way instead: it shrinks to a single control, the current tab, and every action stays (rule 3).

  3. 9:41
    9:41

    A list people browse

    9:41
    9:41

    An editor: a task to finish

    Even less. On the list, Filter leaves too; New and Comments stay, both with a high priority (rule 6). On the editor, nothing more leaves: Back, Done, and the three actions are all still there. Nothing has disappeared: what left is in the overflow menu (rule 8).

FAQ

Why do my toolbar buttons move into the overflow menu on iPhone Duo?

On the side, your app’s controls share the height with the status bar and the Dynamic Island. On the outer display in landscape, or when a Live Activity or the keyboard takes room, there’s less of it: the system moves items into the overflow menu, from the bottom up by default.

What compresses first on iPhone Duo, the toolbar or the tab bar?

By default, the toolbar: its items move into the overflow menu, and the tab bar stays whole. On a screen where people finish a task, the app can ask for the opposite, screen by screen: the tab bar shrinks to a single control, and the actions stay visible.

How do I choose which toolbar items stay visible on iPhone Duo?

Give them a visibility priority, first by group, then item by item. Apple keeps frequently used actions, like Compose in Mail, and items with badges visible the longest.

My app already has its own overflow menu: what happens to it on iPhone Duo?

Move its actions into the system’s overflow menu: one menu, behind the three dots, where people find everything. Give any other menu a different symbol.

Can an action disappear in one pose of iPhone Duo?

No. It can leave the bar for the overflow menu, but it stays within reach in every pose: Apple asks for the same controls, however people hold the device.

Sources

  1. Designing for iPhone Duo, Apple Human Interface Guidelines, September 9, 2026
  2. Design for iPhone Duo, Apple Developer, Tech Talk
  3. Raise the bar with iPhone Duo, Apple Developer, Tech Talk
  4. Preparing your app for iPhone Duo, Apple Developer Documentation