Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Category Direction - Navigation

Introduction and how you can help

Thanks for visiting the Navigation category direction page in GitLab. This page belongs to the Growth, Expansion Team of the Growth stage and is maintained by Tim Hey (E-Mail). A good portion of this page was inspired by the work our UX department has done over the years leading the way in research and design for the Navigation of GitLab. As a product team, our job will be to join forces with UX and Engineering teams to make our navigation lovable and improve our system usability for the wider GitLab community.

This strategy is a work in progress, and everyone can contribute:


We are responsible for creating navigational structures that are intuitive, in tune with user needs, and representative of the numerous workflows of our community of users. However, when designing for the needs of so many different people, we often have to make compromises and not everyone is pleased with the result. Navigation is not just about getting from point A to B; it can shape workflows, empower users to discover new, more efficient ways of working, and ultimately determine how comfortable users are with a product. From the moment users log in for the first time to when they start diving deeper into GitLab’s diverse feature set, our navigation structure is critical for shaping the user's path and, ultimately, their success in using GitLab.

Where we are Headed

We want to provide a better experience for users to complete common navigational tasks. These include:

Navigation is currently project and group centric. It’s easy enough to find “Project Things” and “Group Things” such as a project issue list, but it’s harder for an individual to find “My Things”, such as an aggregate of their MR pipelines. We don’t provide users with tools to quickly get to items that are important to them. This is where we are headed.

Our current navigation is centered around projects and groups which is great.


graph TD Project-->Project_MRs Project-->Project_Issues Project-->Project_Pipelines Project-->Project_Files Project-->Project_Activity


graph TD Group-->Group_Members Group-->Group_Epics Group-->Group_MRs Group-->Group_Issues Group-->Group_Activity

In the future we need to also enable a user centric navigation that feels more like this.


graph TD Me-->Things_I_watch Me-->Issues_I_create Me-->MRs_I_contribute_to Me-->Pipelines_for_MRs_or_projects_I_work_on Me-->People_I_follow

Target Audience and Experience

In short, all roles & personas interact with navigation. We are focusing on helping users orient themselves around the things that are most important to them, so they can be more productive.

What's Next & Why

Areas of focus:

  1. Global or "Top" Navigation - Epic
  2. Contextual or "Left Sidebar" Navigation - Epic
  3. Other UI features that aid in findability from a browse and discover standpoint (this excludes search, which is about locating a known object)

What is Not Planned Right Now

We have not planned to do launch a whole new experience. The work we have in the backlog to enhance the navigation is rather high in volume and many of the issues are heavy in weight. At this time we are focusing on issues that we can ship quickly that will have a high impact on how users interact with Gitlab.

Maturity Plan

This category is currently at the "Viable" maturity level, and our next maturity target is "Complete" by 2021 (see our definitions of maturity levels).

Top user issue(s)

Recently, we conducted system usability research to better understand how our users interact with GitLab and also benchmark our results. In the feedback from the open text of the survey, we found a few key themes that tie back to our navigation. Below is a list of videos explaining our findings.

Top internal customer issue(s) and epic(s)

Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license