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
| Feature | Single File Editor | Web IDE |
|---|---|---|
| Files per edit | One | Many |
| File tree | No | Yes |
| Search across files | No | Yes |
| Source control panel | No | Yes |
| Best for | A one-line fix | A 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 │ │ │ │ └────────────┘ │ └────────────────────────────────┘ │ └──────┴─────────────────┴──────────────────────────────────────┘
| Area | Purpose |
|---|---|
| Activity bar | Switches between the file explorer, search, and source control |
| Explorer | Shows the folder tree for browsing and creating files |
| Editor area | Holds open files in tabs with colored syntax |
| Source control | Lists changed files and holds the commit message box |
Edit Files
- Select a file in the Explorer. The file opens in a tab.
- Type your changes. The editor colors the code and suggests matching brackets.
- 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
- Select the Source Control icon. A badge shows the number of changed files.
- Review the list. Click a file to see a side-by-side comparison of old and new text.
- Type a clear commit message, such as "Fix typo in welcome heading".
- Choose where the commit goes.
| Choice | Result |
|---|---|
| Commit to the current branch | The change lands on the branch you opened |
| Commit to a new branch | GitLab 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
| Action | Windows and Linux | Mac |
|---|---|---|
| Open the Command Palette | Ctrl+Shift+P | Cmd+Shift+P |
| Open a file by name | Ctrl+P | Cmd+P |
| Search all files | Ctrl+Shift+F | Cmd+Shift+F |
| Toggle the side panel | Ctrl+B | Cmd+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.
