Breaking change deployments on GitLab.com

Changes are deployed continuously to GitLab.com. However, breaking changes can require more time to prepare for.

In the month before the GitLab 18.0 release, breaking changes will be deployed during three time windows. The following tables list when each breaking change will be deployed.

Window 1

This window takes place on April 21 - 23, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation	Impact	Stage	Scope	Check potential impact
CI/CD job token - Limit access from your project setting removal	High	Software supply chain security	Project	Refer to the Understanding this change section for details.
CI/CD job token - Authorized groups and projects allowlist enforcement	High	Software supply chain security	Project	Refer to the Understanding this change section for details.
Replace `add_on_purchase` GraphQL field with `add_on_purchases`	Low	Fulfillment	Instance, group
Replace namespace `add_on_purchase` GraphQL field with `add_on_purchases`	Low	Fulfillment	Instance, group
Deprecation of `name` field in `ProjectMonthlyUsageType` GraphQL API	Low	Fulfillment	Project
Deprecation of `STORAGE` enum in `NamespaceProjectSortEnum` GraphQL API	Low	Fulfillment	Group
DAST `dast_devtools_api_timeout` will have a lower default value	Low	Application security testing	Project
API Discovery will use branch pipelines by default	Low	Application_security_testing	Project
Application Security Testing analyzers major version update	Low	Application security testing	Project

Window 2

This window takes place on April 28 - 30, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation	Impact	Stage	Scope	Check potential impact
Limit number of scan execution policy actions allowed per policy	Low	Security risk management	Instance, group, project
Behavior change for Upcoming and Started milestone filters	Low	Plan	Group, project

Window 3

This window takes place on May 5 - 7, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation	Impact	Stage	Scope
Deprecate Terraform CI/CD templates	Medium	Deploy	Project
Deprecate license metadata format V1	Low	Secure	Instance
The `direction` GraphQL argument for `ciJobTokenScopeRemoveProject` is deprecated	Low	Govern	Project
Dependency Proxy token scope enforcement	High	Package	Group
Remove duoProAssignedUsersCount GraphQL field	Low	Plan	Group, project

Docs

Edit this page to fix an error or add an improvement in a merge request.

Create an issue to suggest an improvement to this page.

Product

Create an issue if there's something you don't like about this feature.

Propose functionality by submitting a feature request.

Feature availability and product trials

View pricing to see all GitLab tiers and features, or to upgrade.

Try GitLab for free with access to all features for 30 days.

Get help

If you didn't find what you were looking for, search the docs.

If you want help with something specific and could use community support, post on the GitLab forum.

For problems setting up or using this feature (depending on your GitLab subscription).

Request support