GitLab Web Editor (FREE)
Sometimes it's easier to make quick changes directly from the GitLab interface than to clone the project and use the Git command-line tool. In this feature highlight, we look at how you can create a new file, directory, branch, or tag from the file browser. All of these actions are available from a single dropdown list.
Create a file
From a project's files page, select the '+' button to the right of the branch selector. Choose New file from the dropdown list.
Enter a filename in the Filename box. Then, add file content in the editor area. Add a descriptive commit message and choose a branch. The branch field defaults to the branch you were viewing in the file browser. If you enter a new branch name, a checkbox displays, allowing you to start a new merge request after you commit the changes.
When you are satisfied with your new file, select Commit Changes at the bottom.
You can use shortcuts when editing a file through the Web Editor. It uses the same shortcuts as the Web IDE. For details, read the documentation for Command Palette.
When starting a new project, there are some common files that the new project might need. GitLab displays a message to help you:
When selecting either
.gitignore and so on, a dropdown displays
to provide you a template that may be suitable for your project:
The license, changelog, contribution guide, or
.gitlab-ci.yml file can also
be added through a button on the project page. In this example, the license
has already been created, which creates a link to the license itself.
NOTE: The Set up CI/CD button does not appear on an empty repository. For the button to display, add a file to your repository.
Introduced in GitLab 15.6.
To preview Markdown content in the Web Editor, select the Preview tab. In this tab, you can see a live Markdown preview that updates as you type alongside your content.
To close the preview panel, do one of the following:
- Select the Write tab.
- From the context menu, select Hide Live Preview.
- Introduced in GitLab 13.10 for GitLab SaaS instances.
- Introduced in GitLab 13.11 for self-managed instances.
Web Editor enables you to highlight a single line by adding specially formatted
hash information to the file path segment of the URL. For example, the file path segment
MY_FILE.js#L3 instructs the Web Editor to highlight line 3.
The Web Editor also enables you to highlight multiple lines using a similar pattern. In
this case, the file path segment
MY_FILE.js#L3-10 instructs the Web Editor to
highlight lines 3 to 10 of the file.
You don't need to construct these lines manually. Instead, you can:
Hover over the number of a line you want to be highlighted when sharing.
Right-click the number with your mouse.
Select Copy Link Address in the context menu.
Upload a file
The ability to create a file is great when the content is text. However, this doesn't work well for binary data such as images, PDFs, or other binary file types. In this case, you need to upload a file.
From a project's files page, select the '+' button to the right of the branch selector. Choose Upload file from the dropdown:
After the upload dialog pops up, there are two ways to upload your file. Either drag and drop a file on the popup or use the click to upload link. After you select a file to upload, a file preview displays.
Enter a commit message, choose a branch, and select Upload file when you are ready.
Create a directory
To keep files in the repository organized it is often helpful to create a new directory.
From a project's files page, select the plus button (
+) to the right of the branch selector.
Choose New directory from the dropdown.
In the new directory dialog, enter a directory name, a commit message, and choose the target branch. Select Create directory to finish.
Create a new branch
There are multiple ways to create a branch from the GitLab web interface.
NOTE: Use branch naming patterns to streamline merge request creation.
Create a new branch from an issue
The Create merge request button changed to open the merge request creation form in GitLab 14.8.
If your development workflow requires an issue for every merge request, you can create a branch directly from the issue to speed the process up. The new branch, and later its merge request, are marked as related to this issue. After merging the merge request, the issue is closed automatically, unless automatic issue closing is disabled. You can see a Create merge request dropdown below the issue description.
NOTE: In GitLab 14.8 and later, selecting Create merge request redirects to the merge request creation form instead of immediately creating the merge request.
The Create merge request button doesn't display if:
- A branch with the same name already exists.
- A merge request already exists for this branch.
- Your project has an active fork relationship.
- Your project is private and the issue is confidential.
To make this button appear, one possible workaround is to remove your project's fork relationship. After removal, the fork relationship cannot be restored. This project can no longer be able to receive or send merge requests to the source project, or other forks.
This dropdown contains the options Create merge request and branch and Create branch.
After selecting one of these options, a new branch or branch and merge request
is created based on your project's default branch.
The branch name is based on an internal ID, and the issue title. The example
screenshot above creates a branch named
When you select the Create branch button in an empty repository project, GitLab performs these actions:
- Creates a default branch.
- Commits a blank
README.mdfile to it.
- Creates and redirects you to a new branch based on the issue title.
If your project is configured with a deployment service like Kubernetes,
GitLab prompts you to set up auto deploy
by helping you create a
After the branch is created, you can edit files in the repository to fix
the issue. When a merge request is created based on the newly-created branch,
the description field displays the issue closing pattern
Closes #ID, where
ID is the ID of the issue. This closes the issue when the
merge request is merged.
Create a new branch from a project's dashboard
If you want to make changes to several files before creating a new merge request, you can create a new branch upfront.
From a project's files page, choose New branch from the dropdown list.
Enter a new Branch name.
Optional. Change the Create from field to choose which branch, tag, or commit SHA this new branch originates from. This field autocompletes if you start typing an existing branch or tag.
To return to the file browser on this new branch, select Create branch.
You can now make changes to any files, as needed. When you're ready to merge the changes back to your default branch, you can use the widget at the top of the screen. This widget only appears for a period of time after you create the branch or modify files.
Create a new tag
Tags help you mark major milestones such as production releases and release candidates. You can create a tag from a branch or a commit SHA:
From a project's files page, choose New tag from the dropdown list.
Give the tag a name such as
Choose the branch or SHA from which you want to create this new tag.
Optional. Add a message and release notes. The release notes section supports Markdown format.
Optional. Upload an attachment.
Select Create tag. GitLab redirects you to the tag list page.
When creating or uploading a new file or creating a new directory, you can trigger a new merge request rather than committing directly to your default branch:
Enter a new branch name in the Target branch field.
GitLab displays the Start a new merge request with these changes checkbox.
Commit your changes, and GitLab redirects you to a new merge request form.
If you'd prefer to not use your primary email address for commits created through the web editor, you can choose to use another of your linked email addresses from the User Settings > Edit Profile page.