GitLab 17.10 release notes

On March 20, 2025, GitLab 17.10 was released with the following features.

In addition, we want to thank all of our contributors, including this month's notable contributor.

This month’s Notable Contributor: Alexey Butkeev

Everyone can nominate GitLab’s community contributors! Show your support for our active candidates or add a new nomination! 🙌

Alexey Butkeev is a valued community contributor whose contributions enhance our global reach and user experience. His impactful localization and translation contributions exemplify our Diversity, Inclusion, and Belonging value.

“I’m honored to be selected as the 17.10 MVP and to contribute to making GitLab more accessible and inclusive,” says Alexey. “Localization is a team effort, and I’m grateful to be part of such a supportive community.”

In addition to his code contributions, Alexey took the initiative to find, document, and fix translation errors via GitLab and Crowdin. His thorough research and problem solving make him our 17.10 MVP.

Alexey was nominated by Oleksandr Pysaryuk, Senior Manager, Globalization Technology at GitLab, and supported by Daniel Sullivan, Director of Globalization & Localization at GitLab. “We appreciate your work and support here at GitLab so much,” says Daniel. “Thank you for your part in helping us become a more globally supported company!”

Thank you Alexey for making GitLab more inclusive and transparent!

Primary features

Duo Code Review available in beta

  • Available in: Ultimate
  • Offerings: GitLab.com
  • Add-ons: Duo Enterprise
  • Links: Documentation

Code review is an essential activity of software development. It ensures that contributions to a project maintain and improve code quality and security, and is an avenue of mentorship and feedback for engineers. It’s also one of the most time-consuming activities in the software development process.

Duo Code Review is the next evolution of the code review process.

Duo Code Review can accelerate your development process. When it performs an initial review on your merge request, it can help identify potential bugs and suggest further improvements - some of which you can apply directly from your browser. Use it to iterate on and improve your changes before you add another human to the loop.

Try it out:

  • To start a code review immediately, add @GitLabDuo as a reviewer to your merge request.
  • To refine feedback on your changes, mention @GitLabDuo in a comment.

You can track future progress for Duo Code Review in epic 13008 and related child epics. Feedback can be provided in issue 517386.

Root Cause Analysis available on Gitlab Duo Self-Hosted

You can now use GitLab Duo Root Cause Analysis on GitLab Duo Self-Hosted. This feature is in beta for GitLab Self-Managed instances using GitLab Duo Self-Hosted, with support for Mistral, Anthropic, and OpenAI GPT model families.

With Root Cause Analysis on GitLab Duo Self-Hosted, you can troubleshoot failed jobs in CI/CD pipelines faster without compromising data sovereignty. Root Cause Analysis analyzes the failed job log, quickly determines the root cause of the job failure, and suggests a fix for you.

Note: This feature currently has limited functionality, and full functionality is planned for 17.11. Additional information is available in troubleshooting documentation and in issue 527128.

Please leave feedback on Root Cause Analysis for GitLab Duo Self-Hosted in issue 523912.

Expanded AWS Regions available for GitLab Dedicated failover instances

GitLab Dedicated customers can now select from an expanded list of AWS regions when choosing where to host their failover instance for disaster recovery.

Expanding failover support to additional regions enables GitLab Dedicated customers to fully use the disaster recovery functionality of GitLab Dedicated regardless of which AWS region they need to use to satisfy their data residency needs.

These newly available regions are only available for hosting failover instances as they do not fully support certain AWS features that GitLab Dedicated relies on.

GitLab Query Language views Beta

Tracking and understanding work in progress across GitLab previously required navigating multiple locations, reducing team efficiency and consuming valuable time.

This release introduces GitLab Query Language (GLQL) views Beta so you can create dynamic, real-time work tracking directly in your existing workflows.

GLQL views embed live data queries in Markdown code blocks throughout Wiki pages, epic descriptions, issue comments, and merge requests.

Previously available as an experiment, GLQL views now enter beta with support for sophisticated filtering using logical expressions and operators across key fields, including assignee, author, label, and milestone. You can customize your view’s presentation as tables or lists, control which fields appear, and set result limits to create focused, actionable insights for your team.

Teams can now maintain context while accessing the information they need, creating shared understanding, and improving collaboration — all without leaving their current workflow.

We welcome your feedback on GLQL views as we continue to enhance this feature.

Enhanced markdown experience

GitLab Flavored Markdown has been enhanced with several powerful improvements:

  • Improved math and image handling:

    • Disable math rendering limits in your group or self-hosted instance to handle more complex mathematical expressions.
    • Control image dimensions precisely using pixel values or percentages to better manage content layout.

  • Enhanced editor experience:

    • Continue lists automatically when pressing Enter/Return.
    • Shift text left or right using keyboard shortcuts.
    • Create clear term-definition pairs using description list syntax.
    • Adjust video widths flexibly.

  • Better content organization:

These improvements make GitLab Flavored Markdown more powerful for teams creating and maintaining documentation while offering greater flexibility in how content is presented and organized.

New visualization of DevOps performance with DORA metrics across projects

We are excited to introduce the Projects by DORA metric panel, a new addition to the Value Streams Dashboard. This table lists all projects in the top-level group, with breakdown into the four DORA metrics. Managers can use this table to identify high, medium, and low-performing projects. This information can also help make data-driven decisions, allocate resources effectively, and focus on initiatives that enhance software delivery speed, stability, and reliability.

The DORA metrics are available out-of-the-box in GitLab, and now together with the DORA Performers score panel executives have a complete view into their organization’s DevOps health top to bottom.

New issues look now in beta

  • Available in: Free, Premium, Ultimate
  • Offerings: GitLab.com
  • Links: Documentation

Issues now share a common framework with epics and tasks, featuring real-time updates and workflow improvements:

  • Drawer view: Open items from lists or boards in a drawer for quick viewing without leaving your current context. A button at the top lets you expand to full page view.
  • Change type: Convert types between epics, issues, and tasks using the “Change type” action (replaces “Promote to epic”)
  • Start date: Issues now support start dates, aligning their functionality with epics and tasks.
  • Ancestry: The complete hierarchy is above the title and the Parent field in the sidebar. To manage relationships, use the new quick action commands /set_parent, /remove_parent, /add_child, and /remove_child.
  • Controls: All actions are now accessible from the top menu (vertical ellipsis), which remains visible in the sticky header when scrolling.
  • Development: All development items (merge requests, branches, and feature flags) related to an issue or task are now consolidated in a single, convenient list.
  • Layout: UI improvements create a more seamless experience between issues, epics, tasks, and merge requests, helping you navigate your workflow more efficiently.
  • Linked items: Create relationships between tasks, issues, and epics with improved linking options. Drag and drop to change link types and toggle the visibility of labels and closed items.

Description templates for epics, issues, tasks, objectives and key results

You can now streamline your workflow and maintain consistency across your projects with description templates for work items (epics, tasks, objectives, and key results).

This powerful addition allows you to create standardized templates, saving you time and ensuring all crucial information is included every time you create a new work item.

Change the severity of a vulnerability

When triaging vulnerabilities, you need the flexibility to adjust severity levels based on your organization’s unique security context and risk tolerance. Until now, you had to rely on the default severity levels assigned by security scanners, which might not accurately reflect the risk level for your specific environment.

Now you can manually change the severity of specific vulnerability occurrences to better align with your organization’s security needs. This allows you to:

  • Adjust the severity level of any vulnerability to Critical, High, Medium, Low, Info, or Unknown.
  • Change multiple vulnerabilities’ severity at once from the vulnerability report.
  • Easily identify which vulnerabilities have custom severity levels through visual indicators.

All severity changes are tracked in the vulnerability history and audit events and can only be overridden by your team members who have at least the Maintainer role for the project, or a custom role with the admin_vulnerability permission. This feature gives security teams more flexibility and control over vulnerability prioritization.

Agentic Core

GitLab Duo Chat is now resizable

In the GitLab UI, you can now resize the Duo Chat drawer. This makes it easier to view code outputs, or keep Chat open whilst working with GitLab in the background.

Manage multiple conversations in GitLab Duo Chat

Maintaining context across different topics in GitLab Duo Chat is now easier with multiple conversations. You can create new conversations, browse your conversation history, and switch between conversations.

Previously, starting a new conversation meant losing the context of your existing chat. Now, you can manage multiple conversations on different topics. Each conversation maintains its own context, so for example, you can ask follow-up questions about code explanations in one conversation, whilst preparing a work-plan in another conversation.

When you need to revisit previous discussions, select the new chat history icon to see all your recent conversations. Conversations are automatically organized by most recent activity, making it easy to pick up where you left off.

For your privacy, conversations with no activity for 30 days are automatically deleted, and you can manually delete any conversation at any time.

This feature is currently available only on GitLab.com in the web UI. It is not available in GitLab Self-Managed instances, nor in IDE integrations.

Share your experience with us in issue 526013.

Select models for AI-powered features on GitLab Duo Self-Hosted

On GitLab Duo Self-Hosted, you can now select individual supported models for each GitLab Duo Chat sub-feature on your self-managed instance. Model selection and configuration for Chat sub-features is now in beta.

To leave feedback, go to issue 524175.

AI Impact Dashboard available on GitLab Duo Self-Hosted Code Suggestions

You can now use the AI Impact Dashboard with GitLab Duo Self-Hosted Code Suggestions on your self-managed instance to help you understand the impact of GitLab Duo on your productivity. The AI Impact Dashboard is in beta with GitLab Duo Self-Hosted, and you can use this feature with your self-managed instance and Visual Studio Code, Microsoft Visual Studio, JetBrains, and Neovim IDEs.

Use the AI Impact Dashboard to compare AI usage trends with metrics like lead time, cycle time, DORA, and vulnerabilities. This allows you to measure how much time is saved in your end-to-end workstream using GitLab Duo Self-Hosted, whilst staying focused on business outcomes rather than developer activity.

Please leave feedback on the AI Impact Dashboard in issue 456105.

Meta Llama 3 models available for GitLab Duo Self-Hosted Code Suggestions and Chat

You can now use select Meta Llama 3 models with GitLab Duo Self-Hosted. These models are in beta for GitLab Duo Self-Hosted to support GitLab Duo Chat and Code Suggestions.

Please leave feedback on using these models with GitLab Duo Self-Hosted in issue 523912.

Scale and Deployments

Timestamps of when placeholder users were created

Previously, when you imported groups or projects, you could not see when placeholder users were created. With this release, we’ve added timestamps so you can track the progress of your migration and troubleshoot any issues as they occur.

Bulk edit to-do items

You can now efficiently manage your To-Do List with our improved bulk editing feature. Select multiple to-do items and mark them as done or snooze them in one go, giving you more control over your tasks and helping you stay organized with less effort.

Snooze to-do items

You can now snooze notifications in your To-Do List, allowing you to temporarily hide items and focus on what’s most important right now. Whether you need an hour to concentrate or want to revisit a task tomorrow, you’ll have fine-grained control over when notifications reappear, helping you manage your workflow more effectively.

Request reassignment by using a CSV file

With this release, user contribution mapping now supports bulk reassignment by using a CSV file. If you have a large user base with many placeholder users, group members with the Owner role can:

  1. Download a prefilled CSV template.
  2. Add GitLab usernames or public emails from the destination instance.
  3. Upload the completed file to reassign all contributions at once.

This method eliminates tedious manual reassignment through the UI. To further streamline large-scale migrations, API support for CSV-based reassignment is now also available.

New navigation experience for projects in Your Work

We’re excited to announce significant improvements to the project overview in Your Work, designed to streamline how you discover and access your projects. This update introduces a more intuitive tab-based navigation system that better reflects how users interact with their projects.

  • The new Contributed tab (previously Yours) now displays all projects you’ve contributed to, including your personal projects, making it easier to track your development activity.
  • Find your individual projects faster with the Personal tab, now prominently featured in the main navigation.
  • Access team projects through the Member tab (formerly All), showing all projects where you have membership.
  • The Inactive tab (previously Pending deletion) now provides a comprehensive view of both archived projects and those pending deletion.

Further, if you have the appropriate permissions, you can now edit or delete a project directly from the Your Work projects overview. These changes reflect our commitment to creating a more efficient and user-friendly GitLab experience. The new layout helps you focus on the projects that matter most to your work, reducing the time spent navigating between different project categories.

We value your feedback on this update! Join the discussion in epic 16662 to share your experience with the new navigation system.

Improved project creation permission settings

We’ve improved the project creation permission settings to make them more clear, intuitive, and aligned with our security principles. The improved settings include:

  • Renamed the “Default project creation protection” dropdown to “Minimum role required for project creation” to clearly reflect the setting’s purpose.
  • Renamed the “Developers + Maintainers” dropdown option to “Developers” for consistency across the platform.
  • Reordered the dropdown options from most restrictive to least restrictive access level.

These changes make it easier to understand and configure which roles can create projects within your groups, helping administrators enforce appropriate access controls more confidently.

Thank you @yasuk for this community contribution!

Unified DevOps and Security

Dependency Scanning support for pub (Dart) package manager

Dependency Scanning has added support for pub, the official package manager for Dart. Support for this has been added to our Dependency Scanning latest template and CI/CD component.

This addition was a community contribution from one of our users, Alexandre Laroche. The GitLab Composition Analysis team appreciates this contribution to improve our product, many thanks, Alexandre. If you are interested in learning more about contributing to GitLab please check out our Community Contribution program.

Select a compliance framework as default from the dropdown list on the Frameworks page

Users can set a default compliance framework in the GitLab compliance centre, which is applied to all new and imported projects that are created in that group. A default compliance framework has a default label to help users identify it.

To make it easier to set a compliance framework as default, we are introducing the ability for users to set a framework as default by using the framework dropdown list on the list frameworks page in the compliance center of a top-level group. This feature isn’t available in the compliance center of subgroups nor projects.

Ignore specific revisions in Git blame

  • Available in: Free, Premium, Ultimate
  • Offerings: GitLab.com
  • Links: Documentation

When browsing the history of a repository, there might be commits that aren’t relevant to otherwise meaningful changes in the project. This can happen during:

  • Refactors where you change from one library to another without changing functionality.
  • Implementation of code formatters or linters that require standardizing the entire codebase.

When you look through the history of a project with blame, these kinds of commits make it difficult to understand the changes that occurred. Git supports identifying these commits with a .git-blame-ignore-revs file in your project. GitLab now allows you to toggle the blame view to show or hide these specific revisions in the “Blame preferences” dropdown list, making it easier to understand the history of your project.

Path exclusions for CODEOWNERS

  • Available in: Premium, Ultimate
  • Offerings: GitLab.com
  • Links: Documentation

When teams configure a CODEOWNERS file, it’s common to include broad matching patterns for paths and file types. These broad configurations can be problematic if your documentation, automated build files, or other patterns don’t require a specified Code Owner.

You can now configure the CODEOWNERS file with path exclusions to ignore certain paths. This is helpful when you want to exclude specific files, or paths from requiring a Code Owner approval.

Configurable squash settings in branch rules

  • Available in: Premium, Ultimate
  • Offerings: GitLab.com
  • Links: Documentation

Different Git workflows require different strategies for handling commits when merging between branches. In previous versions of GitLab, you could only set a single strategy for whether commits should be squashed when merging and how strongly that should be enforced. This setup could be error-prone or require developers to make specific choices to follow the project convention for different branch targets.

You can now configure squash settings for each protected branch through branch rules. For example, you can:

  • Require squashing when merging from your feature branch to the develop branch to keep history clean.
  • Disable squashing when merging from the develop branch to main branch when you want the commit history to remain intact.

This flexibility ensures consistent commit history across your project while respecting the unique needs of each branch in your workflow, all without requiring manual developer intervention.

Wider distribution for token expiration notifications

Previously, access token expiry notification emails were only sent to direct members of the group and project in which the token was expiring. Now, these notifications are also sent to inherited group and project members, if the setting is enabled. This wider distribution makes it easier to manage the token before expiry.

Handling of `needs` statements in pipeline execution policies for compliance

To strengthen your control over pipeline execution, jobs enforced in the .pipeline-policy-pre reserved stage are now required to complete before jobs in subsequent stages can begin, regardless of whether the job defines any needs statements. Previously, jobs defined in the .pipeline-policy-pre stage and jobs in subsequent pipelines with a needs statement both started as soon as the pipeline executed. With this enhancement, jobs in subsequent stages must wait for the .pipeline-policy-pre to complete before starting any other jobs without dependencies, helping you enforce ordered execution and ensuring compliance within the security policies.

Our customers rely on reserved stages to enforce compliance and security checks before developer jobs run. A common use case is to enforce a security or compliance check that fails the entire pipeline if the check does not pass. Allowing jobs to run out of order could bypass this enforcement and weaken policy intent. This improvement provides you with a more consistent approach to compliance enforcement.

To inject jobs at the beginning of the pipeline without overriding needs behavior, configure the jobs to use a custom stage with the new custom stages feature that we introduced in 17.9.

Authenticate to private Pages with an access token

  • Available in: Free, Premium, Ultimate
  • Offerings: GitLab.com
  • Links: Documentation

You can now authenticate to private GitLab Pages sites programmatically using access tokens, making it easier to automate interactions with your Pages content. Previously, accessing restricted Pages sites required interactive authentication through the GitLab UI.

This powerful enhancement increases productivity while maintaining security, giving developers more flexibility in how they interact with and distribute private Pages content.

The AI comparison metrics panel on the AI Impact Dashboard now provides month-over-month (MoM) tracking for GitLab Duo Code Suggestions acceptance rate and GitLab Duo Chat usage (MoM%). These new trend-based insights complement the existing Duo Code Suggestions and Duo Chat tiles, which provide a 30-day snapshot of these metrics. With these additional metrics, managers can better measure the AI impact on their software development processes and identify patterns, by comparing Code Suggestions acceptance rate and Duo Chat usage with other SDLC metrics over time.

Docker Hub authentication for the dependency proxy

The GitLab Dependency Proxy for container images now supports authentication with Docker Hub, helping you avoid pipeline failures due to rate limits and giving you access to private images.

Starting April 1, 2025, Docker Hub will enforce stricter pull limits (100 per 6-hour window per IPv4 address or IPv6 /64 subnet) for unauthenticated users. Without authentication, your pipelines might fail once these limits are reached.

With this release, you can configure Docker Hub authentication through the GraphQL API using your Docker Hub credentials, personal access token, or organization access tokens. Support for UI configuration will be available in GitLab 17.11.

Package registry adds audit events

Package registry operations are now logged as audit events so teams can track when packages are published or deleted to meet compliance requirements.

Before this release, there was no built-in way to track who published or made changes to packages. Teams had to create their own tracking systems or manually document package changes to maintain logs of these activities. Now, each audit event shows who made a change, when it happened, how they were authenticated, and exactly what changed in the package.

Audit events for projects are stored either in a group namespace or the project itself for individual project Owners. Groups can turn off audit events to manage storage needs.

Sort access tokens in Credentials Inventory

You can now sort personal, project, and group access tokens in the Credentials Inventory by owner, created date, and last used date. This helps you to locate and identify your access tokens more quickly. Thank you Chaitanya Sonwane for your contribution!

Identify and revoke tokens with token information API

GitLab administrators can now use a unified API to identify and revoke tokens. Previously, administrators had to use endpoints related to the specific type of token. This API allows revocation regardless of the type. For a list of supported token types, see the Token information API.

Thank you Nicholas Wittstruck and the team from Siemens for your contribution!

Configurable token duration with GitLab OIDC provider

When using GitLab as an OpenID Connect (OIDC) provider, you can now configure the duration of ID tokens with the id_token_expiration attribute. Previously, ID tokens had a fixed expiration time of 120 seconds.

Thank you Henry Sachs for your contribution!

Map OmniAuth profile attributes to user

You can now map the Organization and Title profile attributes from an OmniAuth identity provider (IdP) to a user’s GitLab profile. This allows the IdP to be the single source of truth for these attributes, and users can no longer change them.

Extended webhook triggers for expiring tokens

You can now trigger webhook events 60 and 30 days before a project or group access token expires. Previously, these webhook events only triggered 7 days before expiry. This is an optional setting that matches the existing email notification schedule for expiring tokens.

GitLab Runner 17.10

We’re also releasing GitLab Runner 17.10 today! GitLab Runner is the highly-scalable build agent that runs your CI/CD jobs and sends the results back to a GitLab instance. GitLab Runner works in conjunction with GitLab CI/CD, the open-source continuous integration service included with GitLab.

What’s new:

Bug Fixes:

The list of all changes is in the GitLab Runner CHANGELOG.