2019-10-12 21:52:04 +05:30
---
2021-01-29 00:20:46 +05:30
stage: none
group: unassigned
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2019-10-12 21:52:04 +05:30
type: concepts, howto
---
2022-01-26 12:08:38 +05:30
# Profile preferences **(FREE)**
2017-08-17 22:00:37 +05:30
A user's profile preferences page allows the user to customize various aspects
of GitLab to their liking.
2019-10-12 21:52:04 +05:30
To navigate to your profile's preferences:
2023-04-23 21:23:45 +05:30
1. In the upper-right corner, select your avatar.
2021-03-11 19:13:27 +05:30
1. Select **Preferences** .
2018-11-08 19:23:39 +05:30
## Navigation theme
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.
2019-10-12 21:52:04 +05:30
The default theme is Indigo. You can choose between 10 themes:
2018-11-08 19:23:39 +05:30
- Indigo
- Light Indigo
- Blue
- Light Blue
- Green
- Light Green
- Red
- Light Red
- Dark
- Light
2021-03-11 19:13:27 +05:30
- [Dark Mode ](#dark-mode )
2017-08-17 22:00:37 +05:30
2020-06-23 00:09:42 +05:30
## Dark mode
2022-05-07 20:08:51 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/28252) in GitLab 13.1 as an [Alpha](../../policy/alpha-beta-support.md#alpha-features) release.
2020-06-23 00:09:42 +05:30
GitLab has started work on dark mode! The dark mode Alpha release is available in the
spirit of iteration and the lower expectations of
2022-04-04 11:22:00 +05:30
[Alpha versions ](../../policy/alpha-beta-support.md#alpha-features ).
2020-06-23 00:09:42 +05:30
2021-03-11 19:13:27 +05:30
Progress on dark mode is tracked in the [Dark theme epic ](https://gitlab.com/groups/gitlab-org/-/epics/2902 ).
See the epic for:
2020-06-23 00:09:42 +05:30
- A list of known issues.
- Our planned direction and next steps.
2022-11-25 23:54:43 +05:30
If you find an issue that isn't listed, leave a comment on the epic or create a
2020-06-23 00:09:42 +05:30
new issue.
2021-10-27 15:23:28 +05:30
Dark mode is available as a navigation theme, for MVC and compatibility reasons.
[An issue exists ](https://gitlab.com/gitlab-org/gitlab/-/issues/219512 )
to make it configurable in its own section along with support for
different navigation themes.
2020-06-23 00:09:42 +05:30
2021-03-11 19:13:27 +05:30
Dark theme only works with the **Dark** syntax highlighting theme.
2020-06-23 00:09:42 +05:30
2017-08-17 22:00:37 +05:30
## Syntax highlighting theme
2023-05-27 22:25:52 +05:30
> Changing the default syntax highlighting theme for new users and users who are not signed in [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/25129) in GitLab 15.10.
2018-11-08 19:23:39 +05:30
GitLab uses the [rouge Ruby library ](http://rouge.jneen.net/ "Rouge website" )
2020-07-28 23:09:34 +05:30
for syntax highlighting outside of any Editor context. The WebIDE (like Snippets)
2021-03-11 19:13:27 +05:30
uses [Monaco Editor ](https://microsoft.github.io/monaco-editor/ ) and it's provided
[Monarch ](https://microsoft.github.io/monaco-editor/monarch.html ) library for
2023-04-23 21:23:45 +05:30
syntax highlighting. For a list of supported languages, see the documentation of
2020-07-28 23:09:34 +05:30
the respective libraries.
2017-08-17 22:00:37 +05:30
Changing this setting allows you to customize the color theme when viewing any
syntax highlighted code on GitLab.
2019-10-12 21:52:04 +05:30
The default syntax theme is White, and you can choose among 5 different themes:
2017-08-17 22:00:37 +05:30
2021-03-11 19:13:27 +05:30
<!-- vale gitlab.Spelling = NO -->
2017-08-17 22:00:37 +05:30
- White
- Dark
- Solarized light
- Solarized dark
- Monokai
2021-03-11 19:13:27 +05:30
<!-- vale gitlab.Spelling = YES -->
2018-11-08 19:23:39 +05:30
2021-04-17 20:07:23 +05:30
Introduced in GitLab 13.6, the themes [Solarized ](https://gitlab.com/gitlab-org/gitlab/-/issues/221034 ) and [Monokai ](https://gitlab.com/gitlab-org/gitlab/-/issues/221034 ) also apply to the [Web IDE ](../project/web_ide/index.md ) and [Snippets ](../snippets.md ).
2020-05-24 23:13:21 +05:30
2023-05-27 22:25:52 +05:30
You can use an API call to change the default syntax highlighting theme for new users and users
who are not signed in. For more information, see the `default_syntax_highlighting_theme`
in the [list of settings that can be accessed through API calls ](../../api/settings.md#list-of-settings-that-can-be-accessed-via-api-calls ).
2022-06-21 17:19:12 +05:30
## Diff colors
2022-07-23 23:45:48 +05:30
A diff compares the old/removed content with the new/added content (for example, when
2022-07-16 23:28:13 +05:30
[reviewing a merge request ](../project/merge_requests/reviews/index.md#review-a-merge-request ) or in a
2022-06-21 17:19:12 +05:30
[Markdown inline diff ](../markdown.md#inline-diff )).
Typically, the colors red and green are used for removed and added lines in diffs.
The exact colors depend on the selected [syntax highlighting theme ](#syntax-highlighting-theme ).
2023-03-04 22:38:38 +05:30
The colors may lead to difficulties in case of red-green color blindness.
2022-06-21 17:19:12 +05:30
For this reason, you can customize the following colors:
- Color for removed lines
- Color for added lines
2017-08-17 22:00:37 +05:30
## Behavior
2021-02-22 17:27:13 +05:30
The following settings allow you to customize the behavior of the GitLab layout
2017-08-17 22:00:37 +05:30
and default views of your dashboard and the projects' landing pages.
### Layout width
GitLab can be set up to use different widths depending on your liking. Choose
2019-07-07 11:18:12 +05:30
between the fixed (max. `1280px` ) and the fluid (`100%`) application layout.
2021-02-22 17:27:13 +05:30
NOTE:
2019-07-07 11:18:12 +05:30
While `1280px` is the standard max width when using fixed layout, some pages still use 100% width, depending on the content.
2017-08-17 22:00:37 +05:30
2022-10-11 01:57:18 +05:30
### Dashboard
2017-08-17 22:00:37 +05:30
For users who have access to a large number of projects but only keep up with a
2022-10-11 01:57:18 +05:30
select few, the amount of activity on the your dashboard can be
2023-04-23 21:23:45 +05:30
overwhelming. From the **Dashboard** dropdown list, select what you'd like displayed on your
personal dashboard.
2017-08-17 22:00:37 +05:30
2019-10-12 21:52:04 +05:30
### Group overview content
2023-01-13 00:05:48 +05:30
The **Group overview content** dropdown list allows you to choose what information is
2021-04-29 21:17:54 +05:30
displayed on a group's home page.
2019-10-12 21:52:04 +05:30
You can choose between 2 options:
- Details (default)
2022-01-26 12:08:38 +05:30
- [Security dashboard ](../application_security/security_dashboard/index.md )
2019-10-12 21:52:04 +05:30
2018-11-08 19:23:39 +05:30
### Project overview content
2017-08-17 22:00:37 +05:30
2021-01-03 14:25:43 +05:30
The **Project overview content** setting allows you to choose what content you want to
2021-04-29 21:17:54 +05:30
see on a project's home page.
2017-08-17 22:00:37 +05:30
2020-03-13 15:44:24 +05:30
### Tab width
You can set the displayed width of tab characters across various parts of
GitLab, for example, blobs, diffs, and snippets.
2021-02-22 17:27:13 +05:30
NOTE:
2020-03-13 15:44:24 +05:30
Some parts of GitLab do not respect this setting, including the WebIDE, file
editor and Markdown editor.
2019-03-02 22:35:43 +05:30
## Localization
2019-07-07 11:18:12 +05:30
### Language
Select your preferred language from a list of supported languages.
*This feature is experimental and translations are not complete yet.*
2019-03-02 22:35:43 +05:30
### First day of the week
2019-10-12 21:52:04 +05:30
The first day of the week can be customized for calendar views and date pickers.
2019-03-02 22:35:43 +05:30
2019-07-07 11:18:12 +05:30
You can choose one of the following options as the first day of the week:
- Saturday
- Sunday
- Monday
2021-09-30 23:02:18 +05:30
If you select **System Default** , the [instance default ](../admin_area/settings/index.md#default-first-day-of-the-week ) setting is used.
## Time preferences
### Use relative times
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/65570) in GitLab 14.1.
You can select your preferred time format for the GitLab user interface:
- Relative times, for example, `30 minutes ago` .
- Absolute times, for example, `May 18, 2021, 3:57 PM` .
The times are formatted depending on your chosen language and browser locale.
To set your time preference:
1. On the **Preferences** page, go to **Time preferences** .
1. Select the **Use relative times** checkbox to use relative times,
or clear the checkbox to use absolute times.
1. Select **Save changes** .
NOTE:
This feature is experimental, and choosing absolute times might break certain layouts.
2022-11-25 23:54:43 +05:30
Open an issue if you notice that using absolute times breaks a layout.
2019-10-12 21:52:04 +05:30
2023-03-04 22:38:38 +05:30
## Web IDE
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/370139) in GitLab 15.7 [with a flag](../../administration/feature_flags.md) named `vscode_web_ide`. Disabled by default.
FLAG:
On self-managed GitLab, by default this feature is not available. To make it available, ask an administrator to [enable the feature flag ](../../administration/feature_flags.md ) named `vscode_web_ide` . On GitLab.com, this feature is available.
The [Web IDE Beta ](../project/web_ide_beta/index.md ) is
the default editing environment when the `vscode_web_ide` feature
flag is enabled.
To stop using the Web IDE Beta:
1. In the **Web IDE** section, select the **Opt out of the Web IDE Beta** checkbox.
1. Select **Save changes** .
2019-12-26 22:10:19 +05:30
## Integrations
Configure your preferences with third-party services which provide enhancements to your GitLab experience.
### Sourcegraph
2021-02-22 17:27:13 +05:30
NOTE:
2019-12-26 22:10:19 +05:30
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 ](../../integration/sourcegraph.md#enable-sourcegraph-in-user-preferences )
for more information.
2020-11-24 15:15:51 +05:30
### Gitpod
Enable and disable the [GitLab-Gitpod integration ](../../integration/gitpod.md ). This is only
visible after the integration is configured by a GitLab administrator. View
[the Gitpod feature documentation ](../../integration/gitpod.md ) for more information.
2019-10-12 21:52:04 +05:30
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
2023-01-13 00:05:48 +05:30
Each scenario can be a third-level heading, for example `### Getting error message X` .
2019-10-12 21:52:04 +05:30
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->
