## Settings

collapse all expand all
Save Settings to

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

Current Line Blame

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

Use the GitLens: Toggle Line Blame Annotations command to override this setting for the current window

Annotation format
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 options, open User Settings and search for gitlens.currentLine

Git Code Lens

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

Use the GitLens: Toggle Git Code Lens command to override this setting for the current window

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

At the top of the file

Containers scope

At the start of modules, classes, interfaces, etc

Block scope

At the start of functions, methods, etc

For more options, open User Settings and search for gitlens.codeLens

Status Bar Blame

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

Annotation format
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 options, open User Settings and search for gitlens.statusBar

Hovers

Adds detailed blame information accessible via 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)

## Views

Adds rich views to visualize, navigate, and explore

GitLens views can be configured to be shown in different side bar layouts to best match your workflow. You can easily change the default layout (where all views are shown together on the GitLens side bar) below

Default Layout Source Control Layout Contextual Layout
Show Repositories in the
Show File History in the
Show Line History in the
Show Search Commits in the
Show Compare in the
Repositories view

Adds a Repositories view to visualize, navigate, and explore Git repositories

Show in the
Show a comparison of a user-selected reference (branch, tag, etc) to the
Layout branches
Layout files

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

Use compact file layout

Compacts (flattens) unnecessary nesting when using a tree layouts

Use author avatars icons
Automatically refreshes when the file system or any repository changes
Automatically reveal repositories when opening files

For more options, open User Settings and search for gitlens.views.repositories or gitlens.views

File History view

Adds a File History view to visualize, navigate, and explore the revision history of the current file

Show in the
Use author avatars icons
Line History view

Adds a Line History view to visualize, navigate, and explore the revision history of the selected lines of current file

Show in the
Use author avatars icons
Search Commits view

Adds a Search Commits view to search and explore commit histories by message, author, files, id, etc

Show in the
Layout files
Use compact file layout

Compacts (flattens) unnecessary nesting when using a tree layouts

Use author avatars icons

For more options, open User Settings and search for gitlens.views.search or gitlens.views

Compare view

Adds a Compare view to visualize comparisons between branches, tags, commits, and more

Show in the
Layout files
Use compact file layout

Compacts (flattens) unnecessary nesting when using a tree layouts

Use author avatars icons

For more options, open User Settings and search for gitlens.views.compare or gitlens.views

## Gutter Blame

Adds on-demand gutter blame annotations for the whole file

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

Toggle annotations
Annotation format
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 same commit as the current line
Add gutter highlight
Add line highlight
Add scroll bar highlight

For more options, open User Settings and search for gitlens.blame

## Gutter Heatmap

Adds on-demand heatmap (age) indicator to the edge of the gutter to show how recently lines were changed

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

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

## Recent Changes

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

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

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

## Dates & Times

Allow relative date formatting
Shows some dates relatively, e.g. 1 day ago Shows dates absolutely, e.g.
Date format
Example date:
Short date format
Example short date:
Menus & Toolbars

Adds many helpful commands to the built-in menus & toolbars

Any changes to these settings will require a reload before they will take effect

Add commands to the editor context menu
Add comparison commands
Add open on remote commands
Add commit details commands
Add file history commands
Add blame commands
Add copy to clipboard commands
Add commands to the editor tab context menu
Add open on remote commands
Add comparison commands
Add file history commands
Add copy to clipboard commands
Add commands to the editor group toolbar
Add comparison commands
Add blame commands
Add commands to the Explorer items context menu
Add open on remote commands
Add comparison commands
Add file history commands
Add copy to clipboard commands
Add commands to the Source Control groups context menu
Add stash changes command to the inline toolbar
Add open & close changed files commands
Add comparison commands
Add stash changes command
Add commands to the Source Control items context menu
Add open on remote commands
Add comparison commands
Add file history command
Add stash changes command
Add copy to clipboard commands

## 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

## Modes

Supports user-defined modes for quickly toggling between sets of settings

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

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

For more options or to add your own custom modes, open User Settings and search for gitlens.modes

#{endOfBody}