--- title: "How to make your paywall iPhone Duo-ready: latest advice" description: "What foldables change for your paywall, and how to design paywalls that feel native for 5+ fold angles" language: "en" publishedAt: "2026-09-28T17:42:32.899Z" updatedAt: "2026-09-28T17:42:32.899Z" authors: - name: "Austin Blake" url: "https://www.revenuecat.com/blog/author/austin-blake" category: "Engineering" categoryUrl: "https://www.revenuecat.com/blog/engineering" canonical: "https://www.revenuecat.com/blog/engineering/paywalls-on-iphone-duo" --- # How to make your paywall iPhone Duo-ready: latest advice What foldables change for your paywall, and how to design paywalls that feel native for 5+ fold angles ## Table of contents - [What is iPhone Duo?](#what-is-iphone-duo) - [Lots of different postures](#lots-of-different-postures) - [Check your close button](#check-your-close-button) - [Official Apple recommendations for paywalls on iPhone Duo](#official-apple-recommendations-for-paywalls-on-iphone-duo) - [Prioritize small adjustments over big rearrangements](#prioritize-small-adjustments-over-big-rearrangements) - [Put Close where people now expect it](#put-close-where-people-now-expect-it) - [Keep anything tappable off the fold](#keep-anything-tappable-off-the-fold) - [Know where your sheet will land](#know-where-your-sheet-will-land) - [Adapting your existing paywall for iPhone Duo](#adapting-your-existing-paywall-for-iphone-duo) - [1. Preview your paywall on iPhone Duo in the paywall editor](#1-preview-your-paywall-on-iphone-duo-in-the-paywall-editor) - [2. Build with Xcode 27.1 and open the Duo simulator](#2-build-with-xcode-271-and-open-the-duo-simulator) - [3. Present your paywall in a sheet](#3-present-your-paywall-in-a-sheet) - [4. Run the checklist](#4-run-the-checklist) - [Why native paywalls help here](#why-native-paywalls-help-here) - [What's next](#whats-next) - [Thank you](#thank-you) - [Further reading](#further-reading) iPhone Duo, Apple's first foldable iPhone, switches between compact and regular widths as it folds. To keep paywalls native in every posture, developers should build with Xcode 27.1, present paywalls in a sheet, move the close button into the system toolbar, and keep prices and controls off the fold. *Last updated: September 28, 2026. This is a living guide — we'll keep updating it as Apple shares more and we ship new RevenueCat Paywalls features for foldables. So bookmark this and check back.* > **Tip:** > Build with Xcode 27.1, present your paywall in a sheet, and add `.toolbarVerticalBehavior(.disabled)` to it if you’re baking in an X button. That's the fastest way to a paywall that looks right on iPhone Duo. The rest of this guide covers everything else you can do to refine it. (For more information, see the section entitled “Check your close button”. iPhone Duo gives your app two very different screens to lay out for, plus everything in between. And your paywall is the one screen where something looking ‘a little off’ costs you real money. A paywall is already one of the hardest screens to get right on a normal iPhone. Now the same paywall has to work on a 5.4-inch outer screen, a 7.6-inch inner screen, sideways, half-folded on a table, and in Split View next to another app. If you present your `PaywallView` in a `.sheet` like most of us do today, it'll show up in every one of those states, so we want to make sure that everything still looks intentional. This guide covers what iPhone Duo is, and what each posture does to your paywall. Plus, what Apple recommends, and exactly how to set up a [RevenueCat paywall](https://www.revenuecat.com/feature/paywalls-lp/) so it feels native on Duo starting today. ## **What is iPhone Duo?** ![iPhone Duo marketing image](https://cdn.sanity.io/images/c3qnx9b0/production/654ea09a3f6f93338687bb616a08b9388f179f6f-1960x1102.jpg) iPhone Duo is Apple's first foldable iPhone. It has a shape like a passport and opens like a book to about the size of an iPad Mini. Pre-orders open Friday October 16, 2026, and iPhone Duo is [available starting](https://www.apple.com/newsroom/2026/09/apple-unveils-iphone-duo/) Friday October 23, 2026. It will be available with iOS 27.1. You can test it today with the iPhone Duo simulator in the Xcode 27.1 beta (get it at [Apple Developer](https://developer.apple.com/news/releases/?id=09182026a)). The simplest way to think about it: closed, it's an iPhone; open, it's much closer to an iPad. Apple's Human Interface Guidelines (HIG) ask you to design for two sizes: compact width on the outside and regular width on the inside. ## **Lots of different postures** This is where things start to get really interesting... iPhone Duo can be closed, fully open, or angled somewhere in between. Apple's hinge API (`[onHingeChange](https://developer.apple.com/documentation/updates/swiftui)` in SwiftUI, `[UIHingeInteraction](https://developer.apple.com/documentation/uikit/uihingeinteraction)` in UIKit) reports these as `.closed`, `.partiallyOpen`, or `.fullyOpen`. On top of that come portrait, landscape, and a few ways to set the phone down. ![Different postures of iPhone Duo](https://cdn.sanity.io/images/c3qnx9b0/production/83c286510c1d4181af36405642f4519d6098fe4c-2222x2222.png) *Different postures of iPhone Duo* ## **Check your close button** Where your X ends up depends on how you present your paywall. **Using `presentPaywallIfNeeded`?** The close button lands in the vertical side bar on the outer display, where iPhone Duo users expect it. Check it in the simulator, but there's nothing to change, as long as you don’t also have a custom close button in your Paywall. **Presenting `PaywallView` yourself in a sheet?** A close button component inside your paywall stays inside the paywall. It doesn't move with the system toolbar. For the most native result, remove it in the editor and add a close button to the sheet's toolbar with the `.cancellationAction` placement: ```swift .sheet(isPresented: $showPaywall) { if #available(iOS 27.1, *) { PaywallView() .toolbarVerticalBehavior(.disabled) } else { PaywallView() } } ``` **Built a custom X into your design?** Any close button you've positioned yourself, whether it's a component in your paywall or an overlay in your own code, stays exactly where you put it. On the outer display, that can put it right next to the camera or the side bar. Check it in the Duo preview in the paywall editor and in the simulator, and move it if it collides. > **Tip:** > The vertical bar is Apple's default. Apple says opting out "works well for sheets with only a single toolbar button," and asks you to treat it as a stable choice rather than toggling it on and off. Then build with Xcode 27.1, check the result in the Duo simulator, and use the Duo preview in the paywall editor to tune your layout for the shorter outer screen and the wider inner one. ## **Official Apple recommendations for paywalls on iPhone Duo** Apple published a new HIG page for iPhone Duo and a set of tech talks alongside it. None of it is written specifically for paywalls or StoreKit, but a handful of the general rules map directly onto how a paywall should behave. ### **Prioritize small adjustments over big rearrangements** Apple asks you to "avoid extreme layout changes as people fold the device" and to "maintain the same functionality across device poses". For a paywall, that means the same packages, prices, trial terms, and call to action whether the phone is open or closed. ### **Put Close where people now expect it** On Duo, toolbars move to a vertical strip on the side. Apple says to reserve the top of that vertical axis for navigation controls like Back or Close. A RevenueCat paywall's close button is a component inside the paywall itself, so it doesn't move with the toolbar. Step 4 below covers the fix. ### **Keep anything tappable off the fold** When the device is partially folded, iOS slides sheets out of the fold for you, so a paywall presented in a sheet is covered. If you present your paywall full screen, the fold runs right through the middle of it. In that case, Apple suggests an even number of columns so nothing straddles the fold — so two package cards side by side work better than three. ### **Know where your sheet will land** On the inner display, sheets are centered by default. You can move one to the leading or trailing edge with `presentationPlacement(_:)`. On the outer display, a sheet with a single button can opt out of the vertical bar and stop just short of the camera. ## **Adapting your existing paywall for iPhone Duo** You don't need to wait for anything new to get a good result on Duo. Here's the setup I'd use, built entirely on features that are live in RevenueCat Paywalls right now. ### **1. Preview your paywall on iPhone Duo in the paywall editor** The RevenueCat paywall editor now includes an iPhone Duo preview. You can switch between open and closed, portrait and landscape. The preview matches the Duo's screen shape, safe areas, and camera, and it shows what the current SDKs render. It's the fastest way to spot problems before you open Xcode. ### **2. Build with Xcode 27.1 and open the Duo simulator** Install the Xcode 27.1 beta, choose iPhone Duo in Device Hub, and use the controls at the bottom of the simulator to open, close, rotate, and fold it. Walk your paywall through every posture above before you change anything, so you know what you're actually fixing. > **Tip:** > You need the Xcode 27.1 beta specifically, not Xcode 27.2. Your simulator has to run iOS 27.1 too, not iOS 27 or iOS 27.2. I learned this one while setting up my own test project, so double-check both before you start. ### **3. Present your paywall in a sheet** A sheet does a lot of Duo work for you. On the inner display, the system centers it by default. When the device is partially folded, the sheet slides away from the fold on its own. The simplest option is RevenueCat's `presentPaywallIfNeeded` modifier. It checks the entitlement for you, presents the paywall in a sheet, and dismisses it once the entitlement is active. On iPad, it shows the paywall in a modal that's roughly iPhone-sized. If you want more control, present `PaywallView` yourself in a `.sheet`. That's the route to take if you want a native Close button in the toolbar, which is the next step. Again, just make sure to check the placement of your close button. ### **4. Run the checklist** Before you ship, walk your paywall through every posture and check: - Close is reachable and doesn't collide with the camera or the side bar - The call to action is visible without scrolling on the closed, landscape screen (or you've made peace with the scroll) - Nothing tappable, and no price or trial term, sits on the fold when partially folded - The inner display in landscape doesn't look stretched - Select a package, fold, and unfold — your selection is still there - It still looks right on a regular iPhone and iPad ## **Why native paywalls help here** This is the part I'm most excited about: RevenueCat Paywalls render natively on iOS, and `PaywallView` is a regular SwiftUI view. That's why everything in this guide works with Apple's own tools. You present it in a system sheet, put its close button in the system toolbar, and let iOS move it out of the fold. Someone who just unfolded a brand-new phone is going to notice a paywall that wasn't built for it. Make sure yours was. ## **What's next** We're actively working on making RevenueCat Paywalls even better on iPhone Duo and other foldable devices, and this guide will grow as that work ships. **Changelog** - **September 24, 2026:** First version. Covers postures, Apple's guidance, the Duo preview in the paywall editor, and presenting your paywall with a native Close button. ## **Thank you** Huge thanks to the Paywalls team for all the work they've been putting into foldables. If you've built a Duo-ready paywall with RevenueCat, I'd love to see it! Send it my way at on X @austnstuff, or to [austin.blake@revenuecat.com](mailto:austin.blake@revenuecat.com). ## **Further reading** - [Prepare your app for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111461/) - [Raise the bar with iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111462/) - [Design for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111466/) - [Designing for iPhone Duo](https://developer.apple.com/design/human-interface-guidelines/designing-for-iphone-duo)