GitLab Web IDE

The Web IDE is a code editor that runs inside your browser. You open a project, change several files, and commit the changes without installing Git or any editor. Quick fixes, documentation updates, and learning exercises fit this tool well.

Think of a shared online document. You open it from any computer, make edits, and save. The Web IDE gives code the same convenience.

Web IDE and Single File Editor Compared

FeatureSingle File EditorWeb IDE
Files per editOneMany
File treeNoYes
Search across filesNoYes
Source control panelNoYes
Best forA one-line fixA change that spans files

Open the Web IDE

Three paths lead to the same editor.

  • Press the period key on any project, file, or merge request page.
  • Select Edit on the project page and choose Web IDE.
  • Open a merge request and select Code → Open in Web IDE.

The period shortcut works only when your cursor sits outside a text box.

Meet the Layout

  ┌──────┬─────────────────┬──────────────────────────────────────┐
  │ Act- │  Side Panel     │  Editor Area                         │
  │ ivity│  ┌────────────┐ │  ┌────────────────────────────────┐  │
  │ Bar  │  │ Explorer   │ │  │ index.html  ×   style.css  ×   │  │
  │      │  │ ├ src/     │ │  ├────────────────────────────────┤  │
  │ 📁   │  │ │ ├ app.js │ │  │ 1  <h1>Welcome</h1>            │  │
  │ 🔍   │  │ │ └ ui.js  │ │  │ 2  <p>Hello world</p>          │  │
  │ ⑂    │  │ └ README   │ │  │ 3                              │  │
  │      │  └────────────┘ │  └────────────────────────────────┘  │
  └──────┴─────────────────┴──────────────────────────────────────┘
AreaPurpose
Activity barSwitches between the file explorer, search, and source control
ExplorerShows the folder tree for browsing and creating files
Editor areaHolds open files in tabs with colored syntax
Source controlLists changed files and holds the commit message box

Edit Files

  1. Select a file in the Explorer. The file opens in a tab.
  2. Type your changes. The editor colors the code and suggests matching brackets.
  3. Press Ctrl+S (Cmd+S on Mac) to keep the change in the workspace.

Right-click inside the Explorer to create, rename, or delete files and folders. Drag a file to move it.

Search Across the Project

Select the magnifying glass in the Activity bar and type a word. The panel lists every matching line with its file name. Click a result to jump to that line.

Commit Your Changes

  1. Select the Source Control icon. A badge shows the number of changed files.
  2. Review the list. Click a file to see a side-by-side comparison of old and new text.
  3. Type a clear commit message, such as "Fix typo in welcome heading".
  4. Choose where the commit goes.
ChoiceResult
Commit to the current branchThe change lands on the branch you opened
Commit to a new branchGitLab creates a branch and offers to open a merge request

Teams that protect the default branch rely on the new-branch option. The merge request carries your change through the normal review.

A Safe Editing Flow

  Open project → Press "."  → Web IDE opens
        ↓
  Edit README.md and docs/setup.md
        ↓
  Source Control → compare changes → write message
        ↓
  Commit to new branch → fix/update-docs
        ↓
  Create merge request → reviewer approves → merge

Work on a Merge Request

Open a merge request in the Web IDE to fix a reviewer comment. Edit the file, commit to the source branch, and the merge request updates. The pipeline reruns on the new commit.

Know the Limits

  • The Web IDE has no built-in terminal for running programs.
  • Large projects load more slowly than a local editor.
  • Extensions are limited to a curated set.
  • Heavy refactoring and debugging belong in a desktop editor.
  • Browser tabs that stay idle for a long time may require a reload. Commit often so that no work is lost.

Useful Shortcuts

ActionWindows and LinuxMac
Open the Command PaletteCtrl+Shift+PCmd+Shift+P
Open a file by nameCtrl+PCmd+P
Search all filesCtrl+Shift+FCmd+Shift+F
Toggle the side panelCtrl+BCmd+B

When to Choose the Web IDE

Pick the Web IDE for documentation fixes, configuration edits, and code reviews that need a small correction. Pick a local editor with Git installed for long coding sessions, test runs, and debugging.