Feature
GitLab
GitLab Design Management — the feature that lets users attach design assets such as wireframes and mockups to issues — is deprecated and begins removal in GitLab 20.0: new uploads stop, and existing designs become read-only until GitLab 21.0
departs 20 May 2027
Quick answers
- Is it true that GitLab Design Management is being removed — no new design uploads from GitLab 20.0 (20 May 2027), read-only until 21.0?
- Yes. GitLab has officially announced it, effective 20 May 2027. Design Management is the GitLab feature that lets you upload design assets — wireframes, mockups, screenshots — directly onto an issue and collaborate on them with comments and version history.
- When does it take effect?
- 20 May 2027. Verified against the vendor's own announcement.
- What should I use instead?
- Treat GitLab 20.0 (20 May 2027) as the date new uploads stop and GitLab 21.0 as the hard deadline to have your designs saved elsewhere, because read-only access ends there.
What this means for you
Design Management is the GitLab feature that lets you upload design assets — wireframes, mockups, screenshots — directly onto an issue and collaborate on them with comments and version history. GitLab announced the deprecation in the 18.6 milestone and will begin removing it in GitLab 20.0, which GitLab's own release schedule dates to 20 May 2027. From GitLab 20.0 and later, users will no longer be able to upload new designs. Existing designs stay available in read-only mode until GitLab 21.0, which is the window GitLab gives you to export and save anything you need. GitLab says the ongoing maintenance of the feature outweighed its usage and that it is focusing on solutions that better fit modern designer workflows; it has not named a built-in replacement, describing the alternatives it is "exploring" as integrations with the tools designers already use. Anyone who relies on GitLab issues as the system of record for design review — product and design teams that pin mockups to issues, agencies that hand off assets through GitLab, teams whose audit trail for design decisions lives in issue-attached designs — needs a plan to get those assets out before read-only access ends at 21.0.
Where to go
Treat GitLab 20.0 (20 May 2027) as the date new uploads stop and GitLab 21.0 as the hard deadline to have your designs saved elsewhere, because read-only access ends there. Before 20.0, audit which issues carry designs you still depend on and export them — download the assets and record the review context (comments, versions) you need to keep, since there is no automated migration to a successor feature. GitLab has not shipped an in-product replacement; it points to integrating external design tools (for example Figma or similar) into your workflow instead, so plan to move design review into whichever tool your team already uses and link back to GitLab issues rather than storing the assets inside them. Track the official removal work item for scope and timing changes.
- Export design assets to an external design tool (e.g. Figma) and link it from GitLab issues — GitLab's stated direction, though it has not named a specific built-in replacement
- Store design files in a repository or object storage and reference them from issues/merge requests
GitLab is removing Design Management, the feature that lets you upload design assets — wireframes, mockups, screenshots — onto a GitLab issue and collaborate on them with comments and version history. GitLab announced the deprecation in its 18.6 milestone and will begin removal in GitLab 20.0, which GitLab’s own release schedule dates to 20 May 2027.
What changes, and when
- From GitLab 20.0 (20 May 2027): users can no longer upload new designs.
- Until GitLab 21.0: existing designs remain available in read-only mode — the window GitLab gives you to save what you need.
- GitLab 21.0 and later: read-only access ends.
GitLab marks this a breaking change and says it made the decision “after careful consideration of existing usage and estimated customer impact,” concluding that the maintenance cost outweighed the usage.
Who this affects
Any team that uses GitLab issues as the home for design review: product and design teams that pin mockups to issues, agencies that hand assets off through GitLab, and anyone whose audit trail for design decisions lives in issue-attached designs. If designs are just an occasional attachment for you, the impact is small; if GitLab issues are your system of record for design collaboration, this removes it.
What to do
There is no built-in successor and no automated migration — GitLab says it is “exploring” alternatives that integrate the tools designers already use, naming none specifically. So:
- Before GitLab 20.0, audit which issues carry designs you still depend on.
- Export those assets and capture the review context (comments, versions) you need to keep, while the data is still accessible.
- Move design review into the tool your team already uses (for example Figma) and link it from GitLab issues rather than storing assets inside them.
Do the export before GitLab 21.0, because read-only access — your last way to retrieve the files from GitLab — ends there. Track GitLab work item gitlab-org#20375 for any change to scope or timing.
Entry changelog
- — last reviewed.
- — Entry created from GitLab's official deprecations and removals page (docs.gitlab.com/ee/update/deprecations.html). Announcement milestone 18.6; removal_milestone 20.0; breaking_change: true; GitLab work item gitlab-org#20375. Date 20 May 2027 is GitLab's own scheduled date for the 20.0 milestone as published in that page's release schedule — not inferred by us. Quoted: new uploads stop "In GitLab 20.0 and later", existing designs "remain available in read-only mode until GitLab 21.0". Not repo-detectable (a hosted GitLab feature, no dependency/image/string fingerprint), so detect is intentionally empty.
Put this countdown in your README
Building on GitLab? Drop this badge into a project’s README or docs — it shows the days left and
refreshes on its own every night from this page.
[](https://lastcall.dev/entries/gitlab-design-management-deprecation) Spot an error or a changed date? Tell us and it’s corrected the same night.