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 - Authorized groups and projects allowlist enforcement | High | Software supply chain security | Project | Refer to the Understanding this change section for details. |
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 |
|---|---|---|---|---|
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 | |
| Limit number of scan execution policy actions allowed per policy | Low | Security risk management | Instance, 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 | 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. |
| 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 | |
| Behavior change for Upcoming and Started milestone filters | Low | Plan | Group, 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