ScreenShipper
Blog
Tools & Workflow

How to Take Screenshots in the Xcode Simulator (Full Resolution)

Take an Xcode simulator screenshot with one click, Command-S or xcrun simctl, find where it saves and match each simulator to an App Store screenshot size.

ScreenShipper team · · 7 min read

Quick answer: In Xcode 27, click the Screenshot button under the device in Device Hub. In Xcode 26 and earlier, press Command-S (File > Save Screen) in the Simulator app. Both save a full-resolution PNG to your Desktop. From Terminal, xcrun simctl io booted screenshot file.png saves it wherever you want. Pick a simulator whose resolution matches the App Store slot you need.

Three Ways to Take an Xcode Simulator Screenshot

All three methods save the device's own pixels. Your Mac's display and the size of the simulator window make no difference. Apple's documentation says screenshots are captured at the full resolution of the device, so an iPhone simulator gives you an image you can use in App Store Connect without resizing it.

MethodWhereSaves toBest for
Screenshot buttonDevice Hub (Xcode 27)DesktopQuick one-off captures, simulators and connected devices
File > Save Screen (Command-S)Simulator app (Xcode 26 and earlier)Desktop by defaultQuick one-off captures
xcrun simctl io booted screenshot file.pngTerminalAny path you passScripts, exact file names, repeatable sets

Device Hub in Xcode 27

Xcode 27 runs simulators in Device Hub, a single window for both simulated and physical devices, instead of the separate Simulator app. Run your app, go to the screen you want, and click the Screenshot button below the device. The PNG lands on your Desktop. Because the same button works for a connected iPhone, you can also capture features the simulator can't fake well, such as the camera.

The Simulator app in Xcode 26 and earlier

Choose File > Save Screen or press Command-S. The file goes to your Desktop with a name like "Simulator Screenshot - iPhone 16 Pro - date". In many versions, holding Option when you save asks you where to put the file. If that prompt doesn't show up, use the Terminal command below, which always takes a path.

Avoid the macOS screenshot shortcut (Shift-Command-4) for store images. It captures the window at your Mac's display resolution, often with the simulator's bezel and shadow, so you get the wrong pixel size.

Take Simulator Screenshots from Terminal with simctl

The command line is the most reliable way to capture a full set with consistent names. These commands work with Xcode 27 as well as older versions.

  1. Run your app on the simulator from Xcode so the device is booted.
  2. Set a clean status bar: xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100 --cellularMode active --cellularBars 4 --wifiBars 3.
  3. Capture the first screen: xcrun simctl io booted screenshot 01-home.png.
  4. Go to the next screen in the app and capture it with a new name (02-search.png, 03-detail.png and so on).
  5. When you're done, reset the status bar with xcrun simctl status_bar booted clear.

A few details save time:

  • booted means "the simulator that is running." If several are booted, list them with xcrun simctl list devices booted and pass the UDID instead of booted.
  • The default format is PNG. Add --type=jpeg if you want a JPEG, for example xcrun simctl io booted screenshot --type=jpeg 01-home.jpg.
  • Switch to dark mode for a second set with xcrun simctl ui booted appearance dark, and back with xcrun simctl ui booted appearance light.
  • Jump straight to a deep-linked screen with xcrun simctl openurl booted yourapp://settings, if your app handles that URL.
  • Run xcrun simctl help io to see every option your Xcode version supports.

The status bar flags are explained in detail in our clean status bar guide.

Which Simulator to Use for Each App Store Size

App Store Connect only accepts exact pixel sizes, so pick the simulator by its output resolution, not by the name on the box. These simulators produce sizes that fit current App Store slots in portrait:

Simulator (example)Screenshot sizeApp Store slot
iPhone 16 Pro Max1320 × 2868iPhone 6.9″ (optional)
iPhone 16 Plus or iPhone 15 Pro Max1290 × 2796iPhone 6.9″ (optional)
iPhone 16 Pro1206 × 2622iPhone 6.3″ (required)
iPhone 16 or iPhone 151179 × 2556iPhone 6.3″ (required)
iPad Pro 13-inch (M4)2064 × 2752iPad 13″ (required if your app runs on iPad)

The 6.3″ iPhone set is required for every iPhone app. The 6.9″ set is optional: if you skip it, App Store Connect scales your 6.5″ screenshots for the largest phones, and you must then provide 6.5″ instead. Newer simulators often share these resolutions, so check a test capture rather than guessing. Our iPhone size guide and iPad size guide list every accepted size, and the free screenshot size checker tells you which slot an image fits.

From Raw Capture to Store-Ready Screenshot

A raw simulator screenshot is honest proof of your UI, and Apple's guideline 2.3.3 asks for exactly that: the app in use, not a splash screen or login page. But a full-bleed capture with no context makes shoppers work out what the app does on their own.

Most store screenshots wrap the real capture in a layout:

  • A short headline that names the benefit ("Plan a week of meals in 5 minutes").
  • A background in your brand color, so the set looks like one product.
  • Optionally a device frame, or a frameless crop that shows the UI larger.

The final image must still match an accepted size exactly, so design at the target size (for example 1206 × 2622) and place the capture inside it. Our step-by-step screenshot guide covers headlines, order and layout.

Common Simulator Screenshot Problems

  • Wrong dimensions on upload. The simulator's resolution doesn't match the slot, or the image was resized. See fixing screenshot upload errors.
  • Real-world status bar. A random time, low battery or carrier name looks careless. Override it before capturing.
  • Alpha channel. If you edit captures in a design tool and export PNG with transparency, App Store Connect can refuse the file. Export flattened RGB; our alpha channel guide shows how.
  • Debug leftovers. Debug menus, test accounts, "Lorem ipsum" and developer banners show up in captures. Use a demo account with realistic, fictional data.
  • Keyboard covering content. Dismiss the keyboard unless the screen is about typing.
  • Simulator-only glitches. Maps, video or the camera can look different from a real device. Capture those screens on hardware.

Automate the Whole Set

Capturing 6 screens on two devices by hand is fine. Capturing 6 screens on three devices in 10 languages is 180 images, and that is where automation pays off. A short shell script that loops over xcrun simctl openurl and xcrun simctl io booted screenshot handles simple apps. For anything bigger, UI tests driven by fastlane can launch each simulator, switch languages and save named files; see our fastlane snapshot guide.

Frequently Asked Questions

Where are Xcode simulator screenshots saved?

Device Hub and the Simulator app save screenshots to your Desktop by default. With xcrun simctl io booted screenshot, the file goes to the path you type, relative to your current Terminal folder.

Why is my simulator screenshot rejected by App Store Connect?

Usually the pixel size doesn't match the slot you dropped it into, or the PNG has an alpha channel. Capture on a simulator whose resolution is listed for that slot and export without transparency.

Can I take a simulator screenshot without the device frame?

Yes. All three methods capture only the screen contents at device resolution, with no bezel. The macOS screenshot shortcut is the one that includes the window frame.

How do I record a video from the simulator?

Run xcrun simctl io booted recordVideo demo.mov and press Control-C to stop. In Device Hub you can also click the Record button below the device. Our app preview video guide covers specs.

Do simulator screenshots count as showing the real app?

Yes. They are captures of your actual build, which is what Apple's guideline 2.3.3 asks for. Just make sure the screens match the version you submit.

Sources

From raw captures to store-ready screenshots

Drop your simulator or emulator captures into a template and export every store size, or frame a single screen with the free mockup generator.

All guides
Tools & Workflow · 6 minClean Status Bar for Screenshots: 9:41, Full Battery and SignalGet a clean status bar in the iOS simulator and Android emulator for screenshots, with 9:41, full battery and full signal via simctl and Android demo mode.Read guide Tools & Workflow · 7 minApp Store Preview Video: Specs, Rules and Storyboard ExamplesWhat an app store preview video needs: Apple's length, format and resolution specs, allowed footage, poster frames, muted autoplay and storyboard examples.Read guide Tools & Workflow · 7 minAutomate iOS Screenshots with fastlane snapshot (Setup Guide)Set up fastlane snapshot to capture iOS screenshots in every language and device: UI test target, SnapshotHelper, Snapfile options, status bar and output.Read guide Tools & Workflow · 6 minHow to Translate App Store Screenshots into 40+ LanguagesTranslate app store screenshots without chaos. Build a string sheet, translate with AI or people, catch overflow, handle RTL and export every language.Read guide Tools & Workflow · 6 minAI App Store Screenshot Generators: What They Can and Can't DoWhat an AI app store screenshot generator can safely do (copy, translation, backgrounds) and why screenshots with AI-invented UI can fail Apple review.Read guide Tools & Workflow · 7 minHow to Make App Store Screenshots in Canva: A Practical GuideMake canva app store screenshots at exact store sizes: custom dimensions, page layouts, device frames, flat JPG export, Canva's limits and a faster option.Read guide