Deprecate GraphQL STORAGE enum in NamespaceProjectSortEnum

GitLab customers with an active subscriptions can reach out to GitLab Support when encountering unexpected problems with this change.


Deprecation Summary

The NamespaceProjectSortEnum enum STORAGE created in !111211 (merged) has been deprecated in favor of EXCESS_REPO_STORAGE_SIZE_DESC !143630 (merged)

Product Usage

  • Usage of the deprecated sortKey - Kibana logs - whole retention period (7 days) - no usage

Breaking Change?

Yes: Use EXCESS_REPO_STORAGE_SIZE_DESC instead of STORAGE

Affected Customers

  • GitLab.com
  • Self-managed
  • Dedicated

Affected Tier

All tiers

Deprecation Milestone

%17.7 (The field has the deprecation note on it since %16.9 -> !143630 (merged))

Planned Removal Milestone

%18.0

Links

  • Simply removing this enum
  • Deprecation MR: !173028 (merged)
  • MR that added the deprecation note on GraphQL field: !143630 (merged)

Checklists

Timeline

Communication Plan

DRIs: @sheldonled

  • Product Manager: @alex_martin
  • As soon as possible, but no later than the third milestone preceding the major release (for example, given the following release schedule: 17.8, 17.9, 17.10, 17.11, 18.0 – 17.9 is the third milestone preceding the major release):
    • A deprecation announcement entry has been created so the deprecation will appear in release posts and on the general deprecation page.
    • Documentation has been updated to mark the feature as deprecated.
    • ☝️ Deprecation MR: !173028 (merged)
  • On the major milestone:
    • The deprecated item has been removed.
    • If the removal of the deprecated item is a breaking change, the merge request is labeled breaking change.
    • Document the migration plan for users, clearly outlining the actions they need to take to mitigate the impact of the breaking change.
      • Documentation has been added to the deprecation annotation in the field

Approvals

  • Product Manager @alex_martin
  • Engineering Manager @jameslopez
  • Senior Engineering Manager / Director @jeromezng
  • Group / Director of Product Management @ofernandez2

References

  • Deprecations, removals, and breaking changes
  • Deprecation guidelines
  • Deprecations and removals doc styleguide
  • REST API Deprecations and REST API breaking changes.
  • GraphQL Deprecations and GraphQL API breaking changes.
  • GitLab release and maintenance policy
  • Videos 📺
    • How to deprecate and remove features in GitLab releases
    • Review of GitLab deprecations and removals policy & Runner team deprecations and removals process
Edited Apr 25, 2025 by Sheldon Led
Assignee Loading
Time tracking Loading