Tutorial: Use the left sidebar to navigate GitLab

Introduced in GitLab 16.0.

Follow this tutorial to learn how to use the new left sidebar to navigate the UI.

Provide feedback in issue 409005.

Enable the new left sidebar

To view the new sidebar:

  1. On the top bar, in the upper-right corner, select your avatar.
  2. Turn on the New navigation toggle.

To turn off this sidebar, return to your avatar and turn off the toggle.

Find your project

Let’s get started exploring the GitLab UI and left sidebar.

  1. Start by finding the project you want to work on. To explore all available projects, on the left sidebar, select Explore:

    Explore

  2. On the right, above the list of projects, type search criteria. The search finds projects with a matching description.

    Search projects

  3. When you find the project you want, select the project name. The left sidebar now shows project-specific options.

    Project-specific options

Your issues, merge requests, and to-do items are listed in the shortcuts at the top:

shortcuts

Customize the sidebar

You can pin menu items if you tend to use them frequently.

  1. Expand the sections until you are viewing the item you want to pin.
  2. Hover over and select the pin ().

    pin

The item is displayed in the Pinned section:

pinned item

Use a more focused view

On the left sidebar, you can also choose a more focused view into the areas you have access to. Change the view to Your work:

Your work

Go to the Admin Area

The Admin Area is also available on the left sidebar:

Admin Area