2.6 KiB

File Annotations

Toggle File Annotations

GitLens adds on-demand annotations for the whole file directly to the editor's scroll bar and in the gutter area, the space beside the line number, to help you gain more insights into your code.

File Blame

File Blame

When activated, GitLens expands the gutter area to show the commit and author for each line of the file, similar to the current line blame. On the right edge of the gutter, an age indicator (heatmap) is shown to provide an easy, at-a-glance way to tell how recently lines were changed (see the Heatmap below for more details). An additional indicator, which highlights other lines that were also changed as part of the current line's commit, is shown both the far left edge and on the scrollbar.

💡 On an active file, use the Toggle File Blame command from the Command Palette to turn the annotation on and off.

⚙️ Use the settings editor to customize the file blame.

File Changes

File Changes

When activated, indicators are shown on the editor to highlight any local, unpublished, changes or lines changed by the most recent commit.

💡 On an active file, use the Toggle File Changes command from the Command Palette to turn the annotation on and off.

⚙️ Use the settings editor to customize the file changes.

Heatmap

File Heatmap

When activated, color-coded indicators are shown on the editor to highlight how recently lines were changed relative to all the other changes in the file. The colors range from hot, orange, to cold, blue, based on the age of the most recent change. Changes are considered cold after 90 days.

💡 On an active file, use the Toggle File Heatmap command from the Command Palette to turn the annotation on and off.

⚙️ Use the settings editor to customize the file heatmap.