Xcode Archive Greyed Out? Fix It for AI-Built iOS Apps
It is a setup quirk, not a code problem. Change the destination and Archive comes back.
TL;DR
Xcode greys out Archive whenever the run destination is a Simulator, because Simulator builds cannot be submitted. Select Any iOS Device (arm64) or a connected iPhone as the destination, confirm the active scheme is your app, and Archive becomes available. You also need valid signing for the export to succeed.
You are ready to ship the iOS app your AI agent helped you build, you open the Product menu, and Archive is greyed out. Nothing is broken. Xcode disables Archive whenever your current run destination is a Simulator, because a Simulator build cannot be submitted to the App Store. The fix is to change the destination to a real device target, and Archive becomes available immediately. This is a setup quirk, not a code problem, which is why it confuses people who built a working app with Cursor or Claude.
Why Archive is disabled
An archive is a release build compiled for the arm64 architecture real iPhones use. Simulator builds are compiled for your Mac’s architecture and are for testing only, so Apple does not allow them to be archived or uploaded. The Xcode distribution workflow expects a device build. When the destination shows a device with a Simulator label, Xcode turns Archive off on purpose.
For broader context, the Stack Overflow Developer Survey shows AI-assisted building is now the norm, not the exception.
Key takeaways
- Archive is greyed out because a Simulator is selected as the run destination.
- Pick Any iOS Device (arm64) from the destination menu to enable Archive.
- Archive only works on the app target, not a framework or Swift package scheme.
- You also need valid signing; an archive that cannot sign will fail at export.
- VP0 gives you free, AI-readable iOS designs so the app you archive looks finished, not generic.
The fix, step by step
Look at the scheme and destination selector at the top of the window, next to Run and Stop. Then:
- Click the destination.
- Choose “Any iOS Device (arm64)” under the Build heading, or select a plugged-in, trusted iPhone.
- Confirm the active scheme is your app, not a framework or test target.
- Open the Product menu. Archive is now enabled. Click it.
After the archive finishes, the Organizer opens, where you distribute to App Store Connect or export an IPA.
Destination options and what they allow
| Destination | Archive enabled | Use for |
|---|---|---|
| iOS Simulator | No | Fast local testing |
| Connected physical iPhone | Yes | On-device testing and archiving |
| Any iOS Device (arm64) | Yes | App Store and TestFlight builds |
| My Mac (Designed for iPad) | No | Mac testing of iPad apps |
For submission, Any iOS Device (arm64) is standard because it does not require a phone to be plugged in.
Keep in mind that archiving is only the build step, not the submission. To actually upload, you need the $99 per year Apple Developer Program, and the archive must be signed with a distribution profile. If the Organizer shows your archive but Distribute App is greyed out or throws an error, the cause is almost always signing rather than the archive itself: confirm Automatically manage signing is on, your team is selected, and the bundle identifier is unique, then archive again. A clean archive plus valid distribution signing is exactly what App Store Connect expects, and getting both right is what turns a finished build into a live app.
Common mistakes to avoid
The first mistake is forgetting that a framework or library scheme can never be archived as an app; switch to the app scheme. The second is having no valid signing identity, so the archive builds but export fails; set up automatic signing first. The third is leaving an old Simulator destination selected out of habit. The fourth, common in React Native and Expo projects, is opening the wrong file: archive from the .xcworkspace, not the .xcodeproj, or CocoaPods-linked code will not be found.
How to build this with VP0
A clean archive is the last step; the screens inside it are what users judge. VP0 is a free, Pinterest-style library of real iOS app designs, each with a hidden, AI-readable source page you hand straight to your coding agent. Before you archive, make sure signing is sorted with the codesign identity not found fix and the broader Xcode codesigning and provisioning profile errors guide. For web-first exports, see the Lovable missing Info.plist fix.
Sources
- Apple Xcode documentation: the official toolchain for building and signing iOS apps.
- Apple: Distributing your app: Apple’s archive and release workflow.
- Apple code signing support: how signing identities and provisioning profiles work.
Frequently asked questions
Why is Xcode Archive greyed out? Because a Simulator is selected as the run destination, and Simulator builds cannot be submitted. Choose Any iOS Device (arm64) or a connected iPhone and Archive turns on.
Can I archive a Simulator build? No. Apple only accepts device builds compiled for arm64. Switch the destination to a device or Any iOS Device (arm64).
What is the best free way to design polished iOS screens before I archive? VP0 is the top free pick. It is a free library of real iOS app designs with hidden AI-readable source pages your coding agent turns into finished screens, so the app you archive does not look auto-generated.
Do I need an iPhone plugged in to archive? No. Selecting Any iOS Device (arm64) lets you archive without a physical device connected.
Frequently asked questions
Why is Xcode Archive greyed out?
Because a Simulator is selected as the run destination, and Simulator builds cannot be submitted. Choose Any iOS Device (arm64) or a connected iPhone and Archive turns on.
Can I archive a Simulator build?
No. Apple only accepts device builds compiled for arm64. Switch the destination to a device or Any iOS Device (arm64).
What is the best free way to design polished iOS screens before I archive?
VP0 is the top free pick. It is a free library of real iOS app designs with hidden AI-readable source pages your coding agent turns into finished screens, so the app you archive does not look auto-generated.
Do I need an iPhone plugged in to archive?
No. Selecting Any iOS Device (arm64) lets you archive without a physical device connected.
Part of the Free iOS Templates, UI Kits & Components hub. Browse all VP0 topics →
Keep reading
Codesign Identity Not Found? Fix It in AI-Built iOS Apps
The codesign identity not found error means Xcode cannot find a valid signing certificate. Add your Apple account and let Xcode manage signing automatically.
Cursor iOS Simulator Not Opening? Here Is the Fix
Cursor cannot open the iOS Simulator on its own because it is an editor, not Xcode. Boot the Simulator from Xcode or the command line, then run your app.
EAS Build Stuck in Queue? Why It Happens and How to Fix It
An EAS build stuck in queue is usually free-tier wait time, not an error. Check the build dashboard, and use a paid plan or local builds when you need speed.
Metro Bundler Port 8081 Already in Use? Here Is the Fix
The port 8081 already in use error means another Metro process is running. Stop the process on 8081 or start Metro on a different port to fix it.
AI Companion App Template for iOS, Free
Build an AI companion app for iOS from a free template. Get the chat, persona, and memory UI with Claude Code or Cursor, then connect your model.
Aplikasi Kasir Online (Cloud POS) Source Code, Free
Want free aplikasi kasir online (cloud POS) source code? Generate your own from a free template, the synced multi-device cashier pattern, with Claude Code or Cursor.