Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

Xcode does not list my iPhone or iPad in the run destination menu

ErrorXcode does not show my iPhone as a destination

Short answer

A physical device only appears in the run destination menu after it is paired with your Mac in Device Hub, and only for schemes that target its platform. Pair it (accept Trust This Computer), turn on Developer Mode, install platform support if offered, and re-pair after an OS upgrade.

  • Applies to Xcode with Device Hub, iOS 26, iPadOS 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Ask xcodebuild which destinations it can use for your scheme. If the phone is not in the list, the problem is pairing or the scheme, not the build.

    xcodebuild -showdestinations -project MyApp.xcodeproj -scheme MyApp
    xcrun devicectl list devices
  2. 2Match what you see, then jump to its fix

    1. 1devicectl does not list the phone, and Device Hub's sidebar has no physical deviceThe device is not paired with this MacFix
    2. 2Device Hub shows a message asking you to turn on Developer Mode, or the switch is missing in SettingsDeveloper Mode is off on the deviceFix
    3. 3The menu shows only another platform's devices, or Any iOS Device has a Get buttonThe scheme does not target this platform, or platform support is missingFix
    4. 4The phone used to work and vanished after an iOS updateThe device operating system was upgraded after pairingFix

What does the error look like?

  • Xcode does not show my iPhone as a destination
  • My iPhone is missing from the Xcode run destination menu

Cause 1 of 4

The device is not paired with this Mac

1Check

Only physical devices paired with the Mac appear in Device Hub and in the run destination menu. Open Device Hub with Manage Devices... in the menu, or Xcode > Open Developer Tool > Device Hub, and filter to Physical Devices.

xcrun devicectl list devices

2Fix

Connect the device with a cable and tap Trust when Trust This Computer appears. In Device Hub select the device and click Pair if the button shows. For wireless pairing, use Pair Nearby Device on the same Wi-Fi network; the device must run iOS or iPadOS 27 or later, otherwise use a cable. If the trust dialog was dismissed or the device does not appear after you tap Trust, restart the device.

xcrun devicectl list devices

3Verify

The device is listed under Available in Device Hub and in the destination menu.

xcodebuild -showdestinations -project MyApp.xcodeproj -scheme MyApp

Confirmed by developer.apple.com

Did this fix it?

Cause 2 of 4

Developer Mode is off on the device

1Check

Xcode cannot run apps on a device with Developer Mode off. The switch under Settings > Privacy & Security only appears after you start pairing, or if the device was paired with a Mac before.

xcrun devicectl list devices

2Fix

Start pairing in Device Hub so the switch appears. Turn on Developer Mode under Privacy & Security, tap Restart in the alert, then after the restart tap Enable and enter the passcode.

# On the device: Settings > Privacy & Security > Developer Mode > On > Restart > Enable

3Verify

Run the app from Xcode once more.

xcodebuild -showdestinations -project MyApp.xcodeproj -scheme MyApp

Confirmed by developer.apple.com

Did this fix it?

Cause 3 of 4

The scheme does not target this platform, or platform support is missing

1Check

The menu is filled from the selected scheme. A scheme with a watchOS app, for example, lists only watchOS devices. Without platform support for the target, you cannot build and run on a device.

xcodebuild -list -project MyApp.xcodeproj

2Fix

Choose a scheme whose target is the iOS app. If a Get button shows beside the Any Device destination, click it to install platform support, or manage it later in Components settings.

xcodebuild -showdestinations -project MyApp.xcodeproj -scheme MyApp-iOS

3Verify

The phone appears under the iOS scheme's destinations.

xcodebuild -showdestinations -project MyApp.xcodeproj -scheme MyApp-iOS

Confirmed by developer.apple.com

Did this fix it?

Cause 4 of 4

The device operating system was upgraded after pairing

1Check

Apple says that after you upgrade a device's operating system you need to pair it again.

xcrun devicectl list devices

2Fix

In Device Hub Control-click the device and choose Unpair, then pair it again with a cable and accept the trust prompt.

# Device Hub: Control-click the device > Unpair, then pair again

3Verify

The device returns under Available.

xcrun devicectl list devices

Confirmed by developer.apple.com

Did this fix it?

How do I stop it coming back?

  • Pair new test devices on the day you get them and turn on Developer Mode then.
  • After each iOS upgrade of a test phone, check Device Hub before the first build.
  • Keep Xcode current so its platform support matches the device's operating system.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Related fixes

Mobile apps

App record creation fails because you lack permission

You cannot add a new app in App Store Connect as a Developer or limited user

Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.

3 causes, each with a fix

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.