Xcode 27.2 RC adds a JSON project format. Try it on a branch
Xcode 27.2 RC can save your project in a JSON-based format, .xcproj, instead of project.pbxproj. The idea to keep: switching is one menu item and Apple says it can be reverted in source control, so try it on a branch and read the diff before you trust it.
What shipped
Apple released Xcode 27.2 RC (build 27B48) on October 19, 2026. It is a release candidate: the Releases page does not list a final version yet. The RC includes Swift 6.4 and needs macOS Tahoe 26.6 or later.
The new feature is called Project Format. The release notes say Xcode now supports a JSON-based project format, .xcproj. Apple's reasons are that the file is more readable, friendlier to merges, and easier for coding agents to edit. A project saved this way also opens in earlier Xcode 27 releases, and Xcode 27 and later support both formats.
Those are Apple's claims. I did not find an independent measurement of any of them, so read "fewer merge conflicts" as a promise to test, not a result.
How to switch
Apple's documentation page gives the steps:
- Select the project in the Project navigator.
- Open the File inspector and find Project Document, then the Project Format menu.
- Choose JSON. If a window appears, choose Continue.
After that, the change shows up in your repository as project.pbxproj removed and .xcproj added. Apple notes that you can revert the file changes in source control.
That last part is why I would do it on a branch first:
git switch -c try-json-project-format
# switch Project Format in Xcode, then:
git status
git diff --stat
If it worked the way Apple describes, the output shows project.pbxproj removed and .xcproj added. Build and run once before you commit anything, so you know the project still behaves the same.
What to check before it reaches main
The diff itself. Apple says the JSON format makes configuration changes in a comparison view match the actions you take in Xcode. That is checkable: change one build setting, then see whether the diff reads like what you did.
Merge conflicts. This is the promise that matters most to a team, and only your own history can confirm it. On my solo projects I don't run into project.pbxproj conflicts, but on team projects I do now and then.
Anything that names the old file. If a script or CI step in your repository points at project.pbxproj by path, it is worth a look before you merge the switch. This is my inference: Apple's page says nothing about third-party tools, so I can't tell you which ones handle .xcproj.
Older Xcode versions. Apple's note says projects in the new format open in earlier Xcode 27 releases. It does not say anything about Xcode 26 or older, so check any teammate or CI machine that is not on Xcode 27 before the format lands on main.
Coding agents. Apple highlights easier editing by agents as a reason for the format. Easier to edit does not mean safe to edit unreviewed: if an agent touches your project file, read that diff like you read its code.
A small experiment worth running
Do not judge the format by reading about it. Pick one change you make often, such as adding a file to a target or changing a build setting, and make it twice: once on your current format and once on a branch with JSON. Put the two diffs side by side. If the JSON diff is shorter and says what you did, Apple's readability claim holds for your project. If it does not, you found that out before your team did.
Then run the merge test. Create two branches that each add a different file to the same target, and merge one into the other, once on each format. Count the conflicts. One small project proves little, but it is more evidence than a release note.
One more thing in the RC: deployment targets
The 27.2 release notes list a known issue: the Xcode 27.2 SDKs for macOS, watchOS, tvOS and visionOS report 27.1 as a valid deployment target, and building with that target can behave unexpectedly. Mac Catalyst has a related note: with a 27.1 or 27.2 deployment target, new APIs may not be usable. While you test the RC, I would not raise a deployment target just to try something.
Where this leaves things
Nothing forces you to switch today: both formats work in Xcode 27 and later, and the 27.2 build is still a release candidate. The cheap experiment is a branch, one menu choice and a close look at the diff. If it reads well and your tooling copes, you have something to bring to your team. If it does not, Apple says you can revert in source control.
Sources
- Releases — Apple Developer — Xcode 27.2 RC (27B48) released October 19, 2026; no final version listed yet
- Xcode 27.2 Release Notes — Swift 6.4, macOS Tahoe 26.6 requirement, the Project Format feature (JSON-based
.xcproj, File inspector, opens in earlier Xcode 27 releases), the deployment target known issue - Updating your Xcode project configuration file format — Apple Developer — the steps to switch,
.pbxprojremoved and.xcprojadded in the diff, reverting in source control, support for both formats in Xcode 27 and later, Apple's claims on diffs, merges and coding agents