## Settings

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

## GitLens Explorer

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

Show the GitLens explorer
When opened, show the
Layout files

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

Use compact layout

Compacts (flattens) unnecessary file nesting when using a tree layout

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 Results

Adds an on-demand GitLens Results view to explore commit searches, visualize comparisions between branches, tags, commits, and more

Layout files
Use compact layout

Compacts (flattens) unnecessary file nesting when using a tree layout

Use author avatars icons

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

## Code Lens

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

Show the Git 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 Git blame annotation to the end of the current line

Show a Git blame annotation at the end of the current line

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 Git blame annotations for the current file to the gutter

Add a heatmap (age) indicator

Quickly tell the age of a line — indicator ranges from bright yellow (newer) to dark brown (older)

Position the heatmap on the
Add author avatars in the gutter
Highlight other lines changed with the current line
Add gutter highlight
Add line highlight
Add scroll bar highlight
Use compact view

Compacts (deduplicates) matching adjacent blame annotations

For more advanced customizations open User Settings and search for gitlens.blame

## Hovers

Adds detailed Git blame information accessible via hovers

Show Git hovers
Show hovers for the current line
Show hovers for the current line
Shown when over the
Add Git blame details
Add Git changes (diff)
Show hovers while annotating
Shown when over the
Add Git blame details
Add Git changes (diff)

## 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
Position the annotation on the
When clicked

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

## Keyboard Shortcuts

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

Use
keyboard shortcuts Alt based 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