## Settings

collapse all expand all
Save to

For advanced customizations refer to the GitLens settings docs and edit your User Settings

## General

General GitLens settings — defaults and globals

### Default Date/Time Display

Use
dates
Absolute date format

### Keyboard Shortcuts

Use
keyboard shortcuts
Alt based ( ⌥ on macOS) shortcuts. Not great for non-English keyboard layouts Chorded shortcuts that start with Ctrl+Shift+G ( ⌥⌘G on macOS). Better for non-English keyboard layouts GitLens won't bind any keyboard shortcuts. Configure your own via the Keyboard Shortcuts editor

Search for gitlens in the Keyboard Shortcuts editor to see the shortcuts and to customize them further

### Menus & Toolbars

Any changes to menu & toolbar settings will require a reload before they will take effect

Add commands to the built-in menus & toolbars
Add commands to the editor context menu
Add comparison commands
Add open in remote commands
Add commit details command
Add file history command
Add blame command
Add copy to clipboard commands
Add commands to the editor tab context menu
Add comparison commands
Add file history command
Add open in remote command
Add commands to the editor group menu & toolbar
Add comparison toolbar commands
Add blame toolbar command
Add open in remote command
Add file history command
Add commands to the explorer context menu
Add open in remote command
Add file history command
Add comparison commands

For more advanced customizations open User Settings and search for gitlens

## GitLens Explorer

Adds a GitLens explorer to navigate and explore repositories or file histories

Show the GitLens explorer
Show in the
When opened, show the
Layout branches
Layout files

Chooses the best layout based on the number of files at each nesting level

Use compact layout

Compacts (flattens) unnecessary nesting when using a tree layouts

Use author avatars icons
Automatically refreshes when the file system or any repository changes

For more advanced customizations open User Settings and search for gitlens.gitExplorer or gitlens.explorers

## GitLens File History Explorer

Adds a GitLens File History explorer to visualize the history of the current file

Show the GitLens File History explorer

The current file history will be shown (docked) in the GitLens explorer

Show in the
Use author avatars icons

## GitLens Results Explorer

Adds an on-demand GitLens Results explorer to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more

Show in the
Layout files
Use compact layout

Compacts (flattens) unnecessary nesting when using a tree layouts

Use author avatars icons

For more advanced customizations open User Settings and search for gitlens.resultsExplorer or gitlens.explorers

## Code Lens

Adds authorship code lens to the top of files and on code blocks

Show the authorship code lenses
Add the author and date of the most recent change for the file or code block
When clicked
Add the number of authors and the most prominent author of the file or code block
When clicked
Add code lens to the following scopes
File scope — added at the top of the file
Containers scope — added at the start of modules, classes, interfaces, etc
Block scope — added at the start of functions, methods, etc

For more advanced customizations open User Settings and search for gitlens.codeLens Use the GitLens: Toggle Git Code Lens command to override this setting for the current window

## Current Line Blame

Adds an unobtrusive blame annotation at the end of the current line

Show a blame annotation at the end of the current line
Annotation format

### Available Tokens

Commit Id | id
Commit Author | author
Commit Message | message
Commit Date Relative, e.g. 1 day ago | ago
Commit Date Absolute, e.g. August 8th, 2016 10:48am | date
Commit Date Relative or absolute based on date setting | agoOrDate
Commit Author, Commit Date Relative date | authorAgo
Commit Author, Commit Date Relative or absolute date | authorAgoOrDate

Learn more about advanced formatting options
Include the annotation when scrolling the editor horizontally

When enabled the annotation can be scrolled into view when it is outside the viewport

For more advanced customizations open User Settings and search for gitlens.currentLine Use the GitLens: Toggle Line Blame Annotations command to override this setting for the current window

## Gutter Blame

Adds on-demand gutter blame annotations for the whole file

Toggle annotations for
Annotation format

### Available Tokens

Commit Id | id
Commit Author | author
Commit Message | message
Commit Date Relative, e.g. 1 day ago | ago
Commit Date Absolute, e.g. August 8th, 2016 10:48am | date
Commit Date Relative or absolute based on date setting | agoOrDate
Commit Author, Commit Date Relative date | authorAgo
Commit Author, Commit Date Relative or absolute date | authorAgoOrDate

Learn more about advanced formatting options
Add a heatmap (age) indicator to show how recently lines were changed

Indicator color reflects the age of the most recent change (hot or cold), while indicator brightness ranges from bright (newer) to dim (older) based on the relative age

Position the heatmap on the
Add author avatars in the gutter
Use compact view

Compacts (deduplicates) matching adjacent blame annotations

Highlight other lines changed by the current line's commit
Add gutter highlight
Add line highlight
Add scroll bar highlight

For more advanced customizations open User Settings and search for gitlens.blame Use the GitLens: Toggle File Blame Annotations GitLens: Toggle File Blame Annotations command to turn the annotations on or off Press Esc to turn off the annotations

## Gutter Heatmap

Adds on-demand heatmap (age) indicator to the edge of the gutter to show how recently lines were changed
Indicator color reflects the age of the most recent change (hot or cold), while indicator brightness ranges from bright (newer) to dim (older) based on the relative age

Toggle annotations for

Use the GitLens: Toggle File Heatmap Annotations GitLens: Toggle File Heatmap Annotations command to turn the annotations on or off Press Esc to turn off the annotations

## Hovers

Adds detailed blame information accessible via hovers

Show blame hovers
Use author avatars icons
Show hovers for the current line
Show hovers for the current line
Shown when over the
Shown when over the
Add blame details
Add changes (diff)
Show hovers while annotating
Shown when over the
Add blame details
Add changes (diff)

## Modes

GitLens supports user-defined modes for quickly toggling between sets of settings

Show the active mode in the status bar
Position the annotation on the

For more advanced customizations or to add your own modes, open User Settings and search for gitlens.modes Use the GitLens: Switch Mode command to quickly switch the active mode Use the GitLens: Toggle Review Mode command to toggle Review mode Use the GitLens: Toggle Zen Mode command to toggle Zen mode

## Recent Changes

Adds on-demand recent changes annotations to highlight lines changed by the most recent commit

Toggle annotations for
Add gutter highlight
Add line highlight
Add scroll bar highlight

Use the GitLens: Toggle Recent File Changes Annotations GitLens: Toggle Recent File Changes Annotations command to turn the annotations on or off Press Esc to turn off the annotations

## Status Bar Blame

Adds a Git blame annotation about the current line to the status bar

Show a Git blame annotation for the current line in the status bar
Annotation format

### Available Tokens

Commit Id | id
Commit Author | author
Commit Message | message
Commit Date Relative, e.g. 1 day ago | ago
Commit Date Absolute, e.g. August 8th, 2016 10:48am | date
Commit Date Relative or absolute based on date setting | agoOrDate
Commit Author, Commit Date Relative date | authorAgo
Commit Author, Commit Date Relative or absolute date | authorAgoOrDate

Learn more about advanced formatting options
Position the annotation on the
When clicked
Reduce flashing when updating the annotation

Avoids clearing the previous blame information when changing lines to reduce status bar "flashing"

For more advanced customizations open User Settings and search for gitlens.statusBar Use the GitLens: Toggle Line Blame Annotations command to override this setting for the current window