<!--
{
  "documentType" : "article",
  "framework" : "Xcode",
  "identifier" : "/documentation/Xcode/Xcode-Cloud",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Xcode Cloud"
}
-->

# Xcode Cloud

Automatically build, test, and distribute your apps with Xcode Cloud to verify changes and create high-quality apps.

## Overview

Xcode Cloud lets you adopt *continuous integration and delivery* (CI/CD), a standard software development practice that helps you develop and maintain your code and deliver apps to testers and users. Xcode Cloud is a CI/CD system that combines the tools you use to create apps and frameworks for Apple platforms: [Xcode](https://developer.apple.com/xcode/), [TestFlight](https://developer.apple.com/testflight/), and [App Store Connect](https://appstoreconnect.apple.com).

![A conceptual illustration that shows how Xcode Cloud builds a project and distributes an app to all kinds of devices.](images/com.apple.Xcode/Xcode-Cloud-Hero~dark@2x.png)

With Xcode Cloud, you can automatically and frequently:

- Build your project.
- Run tests and perform verifications.
- Distribute builds to testers and gather their feedback with [TestFlight](https://developer.apple.com/testflight/) while protecting user privacy.

After successfully verifying a new version of your app with Xcode Cloud and TestFlight, you can quickly release it on the App Store.

For more information about continuous integration and delivery, see [About continuous integration and delivery with Xcode Cloud](/documentation/Xcode/About-Continuous-Integration-and-Delivery-with-Xcode-Cloud). To learn more about configuring your project or workspace to use Xcode Cloud, see [Configuring your first Xcode Cloud workflow](/documentation/Xcode/Configuring-Your-First-Xcode-Cloud-Workflow).

> For additional information about Xcode Cloud that includes videos from WWDC21 and WWDC22, see [The Xcode Cloud toolkit](https://developer.apple.com/news/?id=076p6dmy).

## Topics

### Essentials

[Getting started with Xcode Cloud](/documentation/Xcode/getting-started-with-xcode-cloud)

A quick start guide to getting your project set up with Xcode Cloud for continuous integration, development, and distribution.

[About continuous integration and delivery with Xcode Cloud](/documentation/Xcode/About-Continuous-Integration-and-Delivery-with-Xcode-Cloud)

Learn how continuous integration and delivery with Xcode Cloud helps you create high-quality apps and frameworks.

[Setting up your project to use Xcode Cloud](/documentation/Xcode/Setting-up-your-project-to-use-Xcode-Cloud)

Review account, project, and source control requirements before configuring your project or workspace to use Xcode Cloud.

[Configuring your first Xcode Cloud workflow](/documentation/Xcode/Configuring-Your-First-Xcode-Cloud-Workflow)

Set up your project or workspace to use Xcode Cloud and adopt continuous integration and delivery.

### Setup and maintenance

[Making dependencies available to Xcode Cloud](/documentation/Xcode/Making-Dependencies-Available-to-Xcode-Cloud)

Review dependencies and make them available to Xcode Cloud before you configure your project to use Xcode Cloud.

[Configuring Xcode Cloud for your team](/documentation/Xcode/Configuring-Xcode-Cloud-for-Your-Team)

Start using continuous integration and delivery with Xcode Cloud as a team.

[Sharing macOS and Xcode versions across Xcode Cloud workflows](/documentation/Xcode/Sharing-custom-aliases-across-Xcode-Cloud-workflows)

Use custom aliases to share configurations with multiple workflows.

[Sharing environment variables across Xcode Cloud workflows](/documentation/Xcode/Sharing-environment-variables-across-xcode-cloud-workflows)

Apply common configurations to multiple workflows by using shared environment variables.

[Building Swift packages and Swift Playgrounds app projects with Xcode Cloud](/documentation/Xcode/building-swift-packages-or-swift-playground-app-projects-with-xcode-cloud)

Add your Swift package or Swift Playgrounds app project to an Xcode project to build it in Xcode Cloud.

[Setting the next build number for Xcode Cloud builds](/documentation/Xcode/Setting-the-Next-Build-Number-for-Xcode-Cloud-Builds)

Start numbering builds from a custom build number for your existing Mac app to avoid version collisions.

[Including notes for testers with a beta release of your app](/documentation/Xcode/including-notes-for-testers-with-a-beta-release-of-your-app)

Add text files to your Xcode project to provide notes to beta testers about what to test.

[Removing your project from Xcode Cloud](/documentation/Xcode/Removing-Your-Project-from-Xcode-Cloud)

Remove your project from Xcode Cloud to delete app and workflow data, disconnect your Git repository, and remove the Slack integration.

[Changing the bundle identifier](/documentation/Xcode/changing-the-bundle-identifier)

Modify your app’s bundle identifier and update it anywhere it appears.

### Usage data

[Reviewing Xcode Cloud usage data](/documentation/Xcode/Reviewing-Xcode-Cloud-usage-data)

Access Xcode Cloud usage information to understand how you and your team use Xcode Cloud.

### Workflows

[Developing a workflow strategy for Xcode Cloud](/documentation/Xcode/Developing-a-Workflow-Strategy-for-Xcode-Cloud)

Review how you can best create custom Xcode Cloud workflows to refine your continuous integration and delivery practice.

[Xcode Cloud workflow reference](/documentation/Xcode/Xcode-Cloud-Workflow-Reference)

Configure metadata, start conditions, actions, post-actions, and more to create custom Xcode Cloud workflows.

[Creating a workflow that builds your app for distribution](/documentation/Xcode/Creating-a-workflow-that-builds-your-app-for-distribution)

Configure a workflow to build and sign your app for distribution to testers with TestFlight, in the App Store, or as a notarized app.

[Understanding Xcode Cloud infrastructure validation builds](/documentation/Xcode/Understanding-infrastructure-validation-builds)

Learn about infrastructure validation builds and whether you need to opt out.

### Source code management

[Source code management setup](/documentation/Xcode/Source-Code-Management-Setup)

Allow Xcode Cloud to access your Git repository.

[Configuring requirements for merging a pull request](/documentation/Xcode/Configuring-Requirements-for-Merging-a-Pull-Request)

Protect stable branches by requiring a successful Xcode Cloud build or action before it’s possible to merge a pull request.

### Custom build scripts

[Writing custom build scripts](/documentation/Xcode/Writing-Custom-Build-Scripts)

Extend your Xcode Cloud workflows with custom build scripts that perform custom tasks or install additional tools.

[Environment variable reference](/documentation/Xcode/Environment-Variable-Reference)

Review predefined environment variables you use in custom build scripts.

### Troubleshooting

[Resolving common configuration and build issues](/documentation/Xcode/Resolving-Common-Configuration-and-Build-Issues)

Review common configuration and build issues and learn how you can resolve them.

[Resolve GitHub Enterprise connection issues](/documentation/Xcode/Resolve-GitHub-Enterprise-connection-issues)

Verify that Xcode Cloud can access your GitHub Enterprise repository and fix configuration issues.

[Reporting feedback for Xcode Cloud](/documentation/Xcode/Reporting-feedback-for-xcode-cloud)

Provide feedback on issues you encounter when building with Xcode Cloud.

### Notifications

[Configuring webhooks in Xcode Cloud](/documentation/Xcode/Configuring-Webhooks-in-Xcode-Cloud)

Configure webhooks that connect Xcode Cloud to other services and tools.

[Xcode Cloud webhook payload reference](/documentation/Xcode/Webhook-Payload)

Review details of the webhook payload that Xcode Cloud sends, including the product, workflow, build, actions, results, and SCM metadata associated with it.

[Connecting Xcode Cloud to Slack](/documentation/Xcode/Connecting-Xcode-Cloud-to-Slack)

Connect Xcode Cloud to Slack to keep your team informed about the latest Xcode Cloud builds.

### REST API

  <doc://com.apple.documentation/documentation/AppStoreConnectAPI/xcode-cloud-workflows-and-builds>



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)
