Skip to main content

Docs changelog

This page tracks documentation updates: new guides, updated procedures, and changes reflecting new or updated Bitrise features.

Subscribe to RSS

2026 JuneClick to copy link​

GitHub App integration: event subscriptions clarifiedClick to copy link​

The GitHub App integration page now has an Event subscriptions section explaining that the Bitrise GitHub App subscribes to push, pull_request, and issue_comment events via GitHub's app installation mechanism, not through repo-level webhooks. The section also warns that any existing manual webhooks pointing to hooks.bitrise.io must be removed after switching to the GitHub App to avoid duplicate builds.

Bitrise MCP: new registration tools and API groupClick to copy link​

The Bitrise MCP server now includes a registration API group with two unauthenticated tools — register and verify_registration — that let an AI agent onboard a brand-new Bitrise user without a token. The agent sends a one-time password to the user's email via register, then calls verify_registration with the OTP to receive a personal access token. These tools are most useful with the remote (HTTP) MCP server. See Bitrise MCP tools for the full reference.

Bitrise MCP: install guides added for six toolsClick to copy link​

Step-by-step install guides for the Bitrise MCP server are now available for VS Code, Cursor, Claude, Windsurf, Kiro, Gemini CLI, and other Copilot-compatible IDEs. Each guide covers how to configure the MCP server and authenticate with your Bitrise token. See Bitrise MCP to get started.

Workflow Editor can now push bitrise.yml directly to the repositoryClick to copy link​

The Workflow Editor now supports pushing changes to a repository-stored bitrise.yml directly from the editor — either to the current branch or a new branch — without manually copying and committing. See Storing an app's configuration YAML for the updated flow.

Build Hub: Gradle dependency mirroring explainedClick to copy link​

The Build Hub documentation now includes an explanation of how Gradle dependency mirroring works, giving you a clearer picture of caching behaviour for Gradle projects running on Build Hub.

Configuration YAML docs updated for YAML/Visual mode switcherClick to copy link​

References throughout the docs have been updated to reflect the new toggle between YAML and Visual editing modes in the Workflow Editor. Where instructions previously referred to the left navigation menu, they now point to the YAML toggle at the top of the editor.

New guide: Maven Central repository managerClick to copy link​

A new guide covering the Maven Central repository manager is now available under Build Cache getting started. It explains how Bitrise's proxy cache works for Maven dependencies, covers special cases like dependency verification and custom Docker images, and documents the opt-out process.

Bitrise MCP server: OAuth is now the primary authentication methodClick to copy link​

The Bitrise MCP server now uses OAuth as the primary authentication method. See Bitrise MCP for the updated setup steps.

2026 MayClick to copy link​

In Release Management, you can now create shareable install links. See Custom access links for details.

Modular YAML: increased file and nesting limits for GitHub usersClick to copy link​

The modular YAML configuration guide has been updated to reflect the new, higher file count and nesting limits for GitHub users. See Modular YAML configuration for the updated limits.

Python projects now supportedClick to copy link​

Bitrise now detects Python projects automatically and offers default workflows. The Default workflows and Getting started with web CI guides have been updated to include Python.

2026 AprilClick to copy link​

Next.js and Flutter Web project types documentedClick to copy link​

The Getting started with web CI guide and Default workflows page now cover Next.js (as an extension of Node.js) and Flutter Web project types.

2026 MarchClick to copy link​

M4 machine type added to build machine docsClick to copy link​

The Build machine types page now lists the M4 machine type alongside the existing M4 Pro, M2 Pro, and M1 options, with region availability for each.

Ruby projects now supportedClick to copy link​

Bitrise now detects Ruby projects automatically and offers default workflows. The Getting started with web CI guide has been updated to include Ruby.

Pro Trial: credit card required to access the full trialClick to copy link​

New users now need to provide a valid credit card (which won't be charged) to access the full Pro Trial. The Getting started with Bitrise CI guide has been updated to explain this.

New page: build artifact retention policyClick to copy link​

A dedicated Build artifact retention policy page is now available, covering default retention periods by artifact type, extended retention options for enterprise customers, and the edge case around transferred projects.

Xcode compilation cache: new flag to disable caching without disabling analyticsClick to copy link​

The Xcode compilation cache FAQ now documents the --no-bitrise-build-cache flag, which lets you disable caching temporarily while keeping analytics and build history intact.

2026 FebruaryClick to copy link​

Build Cache: clear cache button replaces Settings dropdownClick to copy link​

The Clearing the Build Cache guide has been updated to reflect the current UI: the Settings dropdown was replaced by a Clear Cache button. The guide includes a new screenshot and a note that clearing the cache requires Workspace owner permissions.

New guide: Endpoint Detection and Response (EDR) on BitriseClick to copy link​

A new page under Integrations explains how Bitrise uses Endpoint Detection and Response (EDR) as part of its corporate security program, and clarifies that EDR agents are not deployed on Bitrise-hosted CI runners.

OIDC for AWS guide updatedClick to copy link​

The OIDC for AWS guide has been updated with additional clarifications on configuration and usage.

New guide: GitHub App migration APIClick to copy link​

A new guide explains how to use the Bitrise API to bulk-migrate projects from OAuth-based GitHub connections to the GitHub App integration, including caveats about reverting the migration. See Adding and managing apps for details.

2026 JanuaryClick to copy link​

Tool setup: new tool versions addedClick to copy link​

The Configuring tool versions guide has been updated with newly supported tool versions in the tool setup feature.

Build artifact retention policy documentedClick to copy link​

The Build artifacts page now includes a section on the artifact retention policy, covering default retention periods by artifact type and options for Enterprise customers. The policy takes effect on March 31, 2026.

Pipeline rebuild: dynamic parallel workflows explainedClick to copy link​

The guide on rebuilding failed pipelines now includes an explanation of how dynamic parallel Workflows affect rebuild options — specifically, when you can rebuild individual Workflows versus all unsuccessful ones. See Rebuilding a failed build for details.