GitLab Interface Tour
GitLab's interface looks complex at first, but it follows a consistent layout. Once you learn the main sections, you can navigate any project or group with confidence.
The Three Levels of GitLab
Everything in GitLab lives at one of three levels. Each level has its own sidebar and menu:
┌─────────────────────────────────────────┐ │ YOUR ACCOUNT │ ← Profile, settings, all projects │ ┌───────────────────────────────┐ │ │ │ GROUP │ ← Team or organization │ │ ┌─────────────────────┐ │ │ │ │ │ PROJECT │ ← One app or codebase │ │ └─────────────────────┘ │ │ │ └───────────────────────────────┘ │ └─────────────────────────────────────────┘
The Top Navigation Bar
The horizontal bar at the very top of the screen stays visible on every page. It contains:
| Icon / Label | What It Does |
|---|---|
| GitLab logo | Takes you back to the home dashboard |
| Search bar | Finds projects, issues, users, and code |
| + (Create) | Quickly creates a new project, group, or snippet |
| Bell icon | Shows your recent notifications |
| Avatar (top right) | Opens profile, preferences, and sign-out |
Your Home Dashboard
The dashboard is the first page you see after logging in. It shows:
- Activity feed — recent events from projects you follow
- Your projects — quick links to recently visited repos
- To-do list — issues and merge requests waiting for your action
Inside a Project — The Left Sidebar
When you open any project, a sidebar appears on the left. This is where most of your work happens.
PROJECT SIDEBAR ─────────────── 📁 Repository ← Browse files, commits, branches 🐛 Issues ← Bug reports and feature requests 🔀 Merge Requests ← Code reviews waiting for approval 🔁 CI/CD ← Pipeline runs, jobs, schedules 📦 Packages ← Container and package registry 🚀 Deployments ← Environments and release history 📊 Analytics ← Code stats and pipeline metrics ⚙️ Settings ← Project name, visibility, members
Repository Section Explained
Files View
The files view shows all folders and files in your project, just like Windows Explorer or macOS Finder. Click any file to read its contents. GitLab highlights code with colour based on the programming language.
Commits
A commit is a saved snapshot of your code at a specific moment. The commits page lists every snapshot in reverse chronological order, with the author's name, a description, and the date.
Commits list example: ───────────────────────────────────────────── abc1234 Fix login bug Sara 2 hours ago bcd2345 Add payment page Arjun 1 day ago cde3456 Initial project setup Riya 3 days ago ─────────────────────────────────────────────
Branches
A branch is a separate copy of the code where you can experiment without affecting the main version. The branches page lists all active branches and shows how far ahead or behind each one is compared to the main branch.
The Merge Requests Page
Merge requests (MRs) are proposals to add changes from one branch into another. Each MR shows:
- Which files changed and exactly what changed (line by line)
- Comments from reviewers
- The pipeline status (did all tests pass?)
- An approve or merge button
The CI/CD Section
This section shows the automated pipeline that runs every time someone pushes code. Each run is called a pipeline, and each step inside it is called a job.
Pipeline run #47 — passed ✅
─────────────────────────────
build → test → deploy
✅ ✅ ✅
(2m 10s) (4m 31s) (1m 05s)
Settings — Where Admins Spend Their Time
The Settings section (visible only to project owners and maintainers) controls:
- Project visibility (public, internal, or private)
- Member roles and permissions
- Webhooks that notify external services
- Protected branches that block direct pushes
- CI/CD variables and secrets
Switching Between Dark and Light Mode
Go to Preferences → Appearance and choose Dark, Light, or System default. GitLab respects your device's system theme if you pick System default.
The Command Palette
Press Ctrl + K (or Cmd + K on Mac) anywhere in GitLab to open the command palette. Type the name of any page, project, or action to jump there instantly without clicking through menus.
┌────────────────────────────────────┐ │ 🔍 Jump to... │ │ > merge req_ │ │ ───────────────────────────── │ │ Merge Requests (my-project) │ │ Create new Merge Request │ └────────────────────────────────────┘
Interface Tips for Beginners
| Shortcut | Action |
|---|---|
| Ctrl + K | Open command palette |
| G then I | Jump to Issues in the current project |
| G then M | Jump to Merge Requests |
| ? | Show all keyboard shortcuts |
GitLab's interface is consistent. Once you learn the sidebar and navigation bar in one project, every other project feels familiar immediately.