Functions are versioned and tested programs that set up what your jobs need, from installing Node to configuring AWS credentials. You and your coding agent can find and configure them from the CircleCI CLI or MCP server. With functions you can: Pin each function to a version like a normal package, and upgrade to the latest versions with circleci function update Catch version and input mistakes bef…
Before Upgrading See the CircleCI server 4.9 release notes and upgrade guide for this release. If you mirror images to a private registry or run an air-gapped install, copy the new Kong and datastore images before you upgrade. See Configuration Changes below. NOTE: Vault is being deprecated and will no longer be supported in server 5.0. Refer to our script for steps to migrate to Tink. What’s New…
Before Upgrading See the CircleCI server 4.10 release notes and upgrade guide for this release. If you mirror images to a private registry or run an air-gapped install, copy the new Kong and datastore images before you upgrade. See Configuration Changes below. NOTE: Vault is being deprecated and will no longer be supported in server 5.0. Refer to our script for steps to migrate to Tink. What’s New…
GitHub check runs for CircleCI workflows now clearly indicate when a workflow is paused at a manual approval job, along with a link to the workflow so you can act on it. Clearer summary: the headline shows workflow state, job counts, and elapsed time, followed by a one-line explanation of the current status. Table layout: jobs are listed in a Status / Job / Duration table, with failed and on-hold…
When you re-run a workflow from a GitHub check, CircleCI now attributes the re-run to the CircleCI user who clicked Re-run, not the user who started the original workflow. This matches how re-running from the CircleCI web app already works. Contexts, security groups and permissions are checked against the user who requested the re-run. Their identity is used for the new workflow, including CIRCLE_…
The Xcode 27.2 RC 1 image is now available to be used in CircleCI pipelines. The full manifest of installed software can be found here.
CLI v1.11.0 adds circleci notification slack commands, so you can script Slack setup across projects instead of clicking through each one. circleci notification slack set --channel #ci-alerts connects a project to a channel. Use a channel name or ID (private channels need the ID). circleci notification slack set --disable / --enable pauses or resumes notifications and keeps the channel configurati…
We consolidated the project creation flow into a single page, so setting up a new project takes fewer steps and less time. If your repository does not have an existing config file, we now provide an AI prompt to generate one with your preferred agent. This flow is only available for orgs using CircleCI’s GitHub App, GitLab Cloud, GitLab Self-Managed, or Cursor Origin (in beta) integration.
Rebuilt Container Runner and Machine Runner with a patched Go release that stops trusting the compromised eMudhra and Comodo AAA root certificate authorities, in response to the October 2026 eMudhra intermediate CA key compromise. We recommend that all users upgrade. This addresses CVE-2026-111943. See our Discuss Post for more details.
Security Rebuilt Machine Runner Orchestrator with a patched Go release that stops trusting the compromised eMudhra and Comodo AAA root certificate authorities, in response to the October 2026 eMudhra intermediate CA key compromise. We recommend that all users upgrade. This addresses CVE-2026-111943. See our Discuss Post for more details.
CircleCI now issues a third version of its OIDC (OpenID Connect) token, alongside the V1 and V2 tokens. In V3 the subject (sub) claim covers where the code was checked out from and where the pipeline config came from. What’s new Jobs now get the V3 token in $CIRCLE_OIDC_TOKEN_V3, alongside $CIRCLE_OIDC_TOKEN and $CIRCLE_OIDC_TOKEN_V2. The V3 sub claim has a new format, shown below. It looks like o…
The Xcode 27.2 Beta 3 image is now available to be used in CircleCI pipelines. The full manifest of installed software can be found here.
The Xcode 27.1 image is now available to be used in CircleCI pipelines. The full manifest of installed software can be found here.
You can now assign a scope to Personal API Tokens, controlling exactly what access a token grants. Previously, every Personal API Token was issued with full admin-level access, regardless of what the token was actually used for. Now, when creating a new token, you can choose one of three scopes - Read, Write or Admin. This lets you issue narrowly-scoped tokens for CI integrations, scripts, or thir…
Instead of always starting with full parallelism as set in the config, Dynamic Parallelism can scale the number of parallel nodes your test job needs depending on the number of tests that were selected by Smarter Testing’s Intelligent Test Selection. Why we built this: Parallelism used to be fixed in config, so a job set to 100 nodes started all 100 even when test selection picked only a handful o…
We are adding two AWS compute regions, us-west-1 and us-west-2. They join us-east-2 as fallback regions. CircleCI uses a fallback region when capacity is not available in the primary region. This change improves availability. What is affected Machine executor jobs and remote Docker can run in a fallback region. Reduce cross-region ECR costs If you’d like to reduce cross-region data transfer charge…
Smarter Testing is now generally available for all Cloud customers. Since beta, teams have used test impact analysis, dynamic test splitting, and automatic rerun of failed tests to run fewer tests, run them faster, and get signal sooner, while maintaining full confidence. What’s included Smarter Testing is a comprehensive set of testing capabilities. The foundational capabilities of test running,…
Machine Runner: Run machine runners on spot or preemptible instances to cut compute costs, without failing jobs when an instance is reclaimed. With the new runner.enable_unsafe_retries option, a job that is still running when the runner receives SIGINT, SIGTERM or SIGHUP is retried on another runner instead of failing. The job restarts from the beginning, so only enable it for jobs that are safe t…
New Run runner VMs on spot nodes to cut compute costs, without failing jobs when a node is reclaimed. Set runner.enableUnsafeRetries on a resource class, and a job that is still running when its VM shuts down is retried on another VM instead of failing. The job restarts from the beginning, so only enable it for jobs that are safe to run more than once. Off by default. Requires machine runner 3.1.1…
The Xcode 27.1 RC 1 image is now available to be used in CircleCI pipelines. The full manifest of installed software can be found here.
Gen2 Arm resource classes for Docker and Linux VM / Remote Docker are now available in Beta on CircleCI, delivering priority access to newer-generation Arm CPUs that are up to 94% faster than gen1 for your Linux workloads, at a lower credit cost. Gen2 Docker (Arm) is available for all users in the following configurations: Size CPU RAM Cost (credits/min) medium.gen2 2 CPU 8 GB 6 large.gen2 4 CPU 1…
The CircleCI plugin for JetBrains IDEs is now available on the JetBrains Marketplace. It brings your CircleCI runs, jobs and config into IntelliJ IDEA and the other JetBrains IDEs, so you can see what CI is doing and act on it without switching to the browser. Follow your runs A CircleCI tool window, next to Commit and Pull Requests, lists your project’s runs with their workflows and jobs undernea…
For customers needing cleanup work to run no matter how a job ends, we now support teardown steps. Add a teardown list to any run step, and CircleCI runs those steps at the end of the job, including when the job fails, is canceled, or times out. Use teardown for saving caches, storing test results, and other cleanup that would otherwise be skipped when a job ends early. It also lets you place a sa…
Slack notifications for on-hold workflows are now actionable. When a workflow is paused at an approval job, the Slack notification includes Approve and Cancel buttons, so you can act on it without opening the CircleCI web app. The buttons appear in both project channel notifications and direct messages, and each action asks for confirmation before it runs. What’s included Approve and Cancel button…
You can now get additional assistance and file support tickets directly from the CircleCI web app with the new in-app support chat. To use it, open the Help menu at the top right of the web app and enable the support chat toggle.
CircleCI is retiring 10 legacy v1 and v1.1 API endpoints used to trigger and rerun builds. They will be removed on February 1, 2027. This extends the date previously communicated by email (November 1, 2026). After that date, requests to these endpoints return HTTP 410 Gone. This change does not affect other v1 or v1.1 endpoints, and it does not affect API v2 or v3. This change applies to both Circ…
API v3 is CircleCI’s current API version, and all new API development happens in v3. Every endpoint follows the same conventions, so you can predict how the API works without reading a spec for each one: UUID resource IDs instead of project slugs Cursor-based pagination One error format with structured error objects Standard rate limit headers, so tools can back off automatically What this means f…
Bitbucket Cloud is retiring SSH access via bitbucket.org on 12 November 2026 and moving it to ssh.bitbucket.org(Atlassian announcement). We are updating CircleCI’s build agent to use the new host so that Bitbucket Cloud checkouts continue to work after the cutover. What’s changing When checking out code from a Bitbucket Cloud repository over SSH, the build agent will now connect to ssh.bitbucket.o…
The Xcode 27.2 Beta 2 image is now available to be used in CircleCI pipelines. The full manifest of installed software can be found here.
Following our Xcode image retention policy, Xcode 14.3.1, 26.3.0, 26.2.0, and 26.1.1 have been marked as deprecated and will be removed on October 30th, 2026. We will be performing 24 hour brownouts from 00:00:01 to 23:59:59 UTC during which these images will be unavailable. The brownout and deprecation schedule can be found below. Brownout #1 Brownout #2 Brownout #3 Removal Date October 13th, 202…