Update your apps for iPhone X.

iPhone X features the stunning 5.8-inch Super Retina display, enabling even more immersive app experiences. Start testing your apps now to make sure they are ready to take advantage of the Super Retina display by respecting safe areas, supporting adaptive layouts, and more.

Run and Test in Simulator

Download the latest version of Xcode 9 and start testing your app in Simulator today. Find and address UI issues in your app before testing on a device to make sure your app looks great on iPhone X.

Enable full screen native resolution. Your app will run in Full Screen Display Mode on iPhone X if your project’s base SDK is set to iOS 11 and you have a Launch Storyboard or iPhone X launch image.

Verify all parts of your app. Make sure that your UI displays correctly and no elements are mispositioned, overlapping, incorrectly scaled, or clipped. If you discover issues, use the safe area guides and layout margins to correctly position UI elements.

If only parts of your app run in Simulator — for example, if it mostly uses UIKit, but has camera integration — you should test as much of your UI as possible by commenting out views that Simulator doesn’t support. For details on using Simulator and on the technologies that it supports, see Simulator Help.

Respect Safe Areas

Your layout should fill the all-screen Super Retina display while content and controls appear correctly and are easily tappable. Use these safe areas to make sure your app works properly with the new dimensions of iPhone X.

Apps with custom layouts can also easily support iPhone X, especially if your app uses Auto Layout and adheres to these guidelines.

Safe areas for iPhone X Safe areas for iPhone X

Status bar. Allow the proper amount of space below the status bar based on the safe area. Avoid assuming a value for the status bar height, as it may cause your content to be obscured or mispositioned below the status bar.

Correct use of status bar safe area for iPhone X
Incorrect use of status bar safe area for iPhone X

Rounded display corners and sensor housing. Keep content and controls away from the corners and sensor housing to allow your app to fill the screen without getting clipped.

Correct use of rounded corners and sensors housing safe area for iPhone X
Incorrect use of rounded corners and sensors housing safe area for iPhone X

Home Indicator. Make sure your app doesn’t interfere with Home Indicator, so your content and controls remain clearly viewable and tappable at all times.

Correct use of Home Indicator safe area for iPhone X
Incorrect use of Home Indicator safe area for iPhone X

Screen Edge Gestures. The display on iPhone X uses screen edge gestures to provide access to Home screen, app switcher, Notification Center, and Control Center. Avoid interfering with these gestures. Move controls into the safe area and adjust your UI. In rare cases, you may consider using edge protect, in which the first swipe invokes the app-specific gesture and a second-swipe invokes the system gesture.

Incorrect use of Screen Edge Gestures safe area for iPhone X

Support Various Aspect Ratios and Orientations

The screen height and aspect ratio of iPhone X is different from other iPhone devices. In portrait orientation, the width of the display on iPhone X matches the width of the 4.7" displays of previous models. However, the display on iPhone X is 145 points taller than a 4.7" display.

Check that your code handles a different screen aspect ratio. Many apps position content based on a particular width, height, or aspect ratio. Verify that your content scales and is positioned correctly.

Correct handling of screen aspect ratio for iPhone X
Incorrect handling of screen aspect ratio for iPhone X
Incorrect handling of screen aspect ratio for iPhone X

Test your app in landscape orientation. While you may discover some issues in portrait orientation, the majority of issues will likely appear in landscape orientation. Be sure to test all of your UI with the device rotated, both to the left and to the right.

Correct handling of landscape orientation for iPhone X
Incorrect handling of landscape orientation for iPhone X

Scale videos accordingly. Video content on iPhone X should fill the display. However, if this results in any cropping on the top or bottom, or too much cropping on the side, the video should be scaled to fit the screen. While AVPlayerViewController manages this automatically, custom video players based on AVPlayerLayer need to select an appropriate initial video gravity setting and allow users to switch between aspect and aspectFill viewing modes based on their preference.

Learn more in the Human Interface Guidelines

Correct video scaling for iPhone X
Incorrect video scaling for iPhone X

Update for Face ID

Verify your Touch ID code works for Face ID. If your app currently uses Touch ID, update text strings to refer to Face ID when running on iPhone X — for example, “Sign in with Face ID.” Avoid using icons to represent Face ID and Touch ID.