A user's profile preferences page allows the user to customize various aspects of GitLab to their liking.
To navigate to your profile's preferences:
- Click your avatar.
- Select Settings.
- Click Preferences in the sidebar.
The GitLab navigation theme setting allows you to personalize your GitLab experience. You can choose from several color themes that add unique colors to the top navigation and left side navigation. Using individual color themes might help you differentiate between your different GitLab instances.
The default theme is Indigo. You can choose between 10 themes:
- Light Indigo
- Light Blue
- Light Green
- Light Red
Introduced in GitLab 13.1 as an Alpha release.
GitLab has started work on dark mode! The dark mode Alpha release is available in the spirit of iteration and the lower expectations of Alpha versions.
Progress on dark mode is tracked in the Dark theme epic. See the epic for:
- A list of known issues.
- Our planned direction and next steps.
If you find an issue that isn’t listed, please leave a comment on the epic or create a new issue.
Dark mode is available as a navigation theme, for MVC and compatibility reasons. In the future, we plan to make it configurable in its own section along with support for different navigation themes.
NOTE: Note: Dark theme currently only works with the 'Dark' syntax highlighting.
Syntax highlighting theme
NOTE: Note: GitLab uses the rouge Ruby library for syntax highlighting outside of any Editor context. The WebIDE (like Snippets) uses Monaco Editor and it's provided Monarch library for syntax highlighting. For a list of supported languages, visit the documentation of the respective libraries.
Changing this setting allows you to customize the color theme when viewing any syntax highlighted code on GitLab.
The default syntax theme is White, and you can choose among 5 different themes:
- Solarized light
- Solarized dark
Introduced in 13.0, the theme you choose also applies to the Web IDE's code editor and Snippets. The themes are available only in the Web IDE file editor, except for the dark theme and the solarized dark theme, which apply to the entire Web IDE screen.
The following settings allow you to customize the behavior of GitLab's layout and default views of your dashboard and the projects' landing pages.
GitLab can be set up to use different widths depending on your liking. Choose
between the fixed (max.
1280px) and the fluid (
100%) application layout.
1280px is the standard max width when using fixed layout, some pages still use 100% width, depending on the content.
For users who have access to a large number of projects but only keep up with a select few, the amount of activity on the default Dashboard page can be overwhelming. Changing this setting allows you to redefine what your default dashboard will be.
You have 8 options here that you can use for your default dashboard view:
- Your projects (default)
- Starred projects
- Your projects' activity
- Starred projects' activity
- Your groups
- Your to-dos
- Assigned Issues
- Assigned Merge Requests
- Operations Dashboard (PREMIUM)
Group overview content
The Group overview content dropdown allows you to choose what information is displayed on a group’s home page.
You can choose between 2 options:
- Details (default)
- Security dashboard (ULTIMATE)
Project overview content
The project overview content setting allows you to choose what content you want to see on a project’s home page.
You can choose between 3 options:
- Files and Readme (default)
You can set the displayed width of tab characters across various parts of GitLab, for example, blobs, diffs, and snippets.
NOTE: Note: Some parts of GitLab do not respect this setting, including the WebIDE, file editor and Markdown editor.
Select your preferred language from a list of supported languages.
This feature is experimental and translations are not complete yet.
First day of the week
The first day of the week can be customized for calendar views and date pickers.
You can choose one of the following options as the first day of the week:
If you select System Default, the system-wide default setting will be used.
Configure your preferences with third-party services which provide enhancements to your GitLab experience.
NOTE: Note: This setting is only visible if Sourcegraph has been enabled by a GitLab administrator.
Manage the availability of integrated code intelligence features powered by Sourcegraph. View the Sourcegraph feature documentation for more information.