Extension Settings

Git Graph Settings

This extension contributes the following settings:

Auto Center Commit Details View

Automatically center the commit details view when it is opened.

• Setting: git-graph.autoCenterCommitDetailsView
• Default: true
• Type: Boolean

Combine Local And Remote Branch Labels

Combine local and remote branch labels if they refer to the same branch, and are on the same commit.

• Setting: git-graph.combineLocalAndRemoteBranchLabels
• Default: true
• Type: Boolean

Commit Details View Location

Specifies where the Commit Details View is rendered in Git Graph view.

• Setting: git-graph.commitDetailsViewLocation
• Default: Inline
• Options:
  • Inline: Show the Commit Details View inline with the graph
  • Docked to Bottom: Show the Commit Details View docked to the bottom of the Git Graph view

Custom Branch Glob Patterns

An array of Custom Branch Glob Patterns to be shown in the 'Branches' dropdown.

• Setting: git-graph.customBranchGlobPatterns
• Default: []
• Type: Array
• Example: [{"name": "Feature Requests", "glob": "heads/feature/*"}]

Date Format

Specifies the date format to be used in the date column of the graph.

• Setting: git-graph.dateFormat
• Default: Date & Time
• Options:
  • Date & Time: Show the date and time, for example "19 Mar 2019 21:34"
  • Date Only: Show the date only, for example "19 Mar 2019"
  • Relative: Show relative times, for example "5 minutes ago"

Date Type

Specifies the date type to be displayed throughout Git Graph, either the author or commit date.

• Setting: git-graph.dateType
• Default: Author Date
• Options:
  • Author Date: Use the author date of a commit
  • Commit Date: Use the committer date of a commit

Default Column Visibility

An object specifying the default visibility of the Date, Author & Commit columns. Each columns visibility is defined by a boolean, such that true => visible, and false => hidden.

• Setting: git-graph.defaultColumnVisibility
• Default: {"Date": true, "Author": true, "Commit": true}
• Type: Object
  • Date: boolean
  • Author: boolean
  • Commit: boolean

Fetch Avatars

Fetch avatars of commit authors and committers. By enabling this setting, you consent to commit author and committer email addresses being sent GitHub, GitLab or Gravatar, depending on the repositories remote origin.

• Setting: git-graph.fetchAvatars
• Default: false (disabled)
• Type: Boolean

Graph Colours

Specifies the colours used on the graph.

• Setting: git-graph.graphColours
• Default: ["#0085d9", "#d9008f", "#00d90a", "#d98500", "#a300d9", "#ff0000", "#00d9cc", "#e138e8", "#85d900", "#dc5b23", "#6f24d6", "#ffcc00" ]
• Type: Array of HEX or RGB colours

Graph Style

Specifies the style of the transitions between branches on the graph.

Rounded	Angular

• Setting: git-graph.graphStyle
• Default: rounded
• Options:
  • rounded: Use smooth curves when transitioning between branches on the graph
  • angular: Use angular lines when transitioning between branches on the graph

Initial Load Commits

Specifies the number of commits to initially load.

• Setting: git-graph.initialLoadCommits
• Default: 300
• Type: Positive Integer

Load More Commits

Specifies the number of commits to load when the "Load More Commits" button is pressed (only shown when more commits are available).

• Setting: git-graph.loadMoreCommits
• Default: 100
• Type: Positive Integer

Max Depth Of Repo Search

Specifies the maximum depth of subfolders to search when discovering repositories in the workspace.

• Setting: git-graph.maxDepthOfRepoSearch
• Default: 0 (don't search subfolders)
• Type: Positive Integer

Note: Sub-repos are not automatically detected when searching subfolders, however they can be manually added by running the command "Git Graph: Add Git Repository" in the Command Palette.

Open Diff Tab Location

Specifies which pane the Visual Studio Code Diff is opened in.

• Setting: git-graph.openDiffTabLocation
• Default: Active
• Options:
  • Active: Open Visual Studio Code Diff in the Active Pane
  • Beside: Open Visual Studio Code Diff beside the Active Pane

Open To The Repo Of The Active Text Editor Document

Open Git Graph to the repository containing the active Text Editor document.

• Setting: git-graph.openToTheRepoOfTheActiveTextEditorDocument
• Default: false
• Type: Boolean

Reference Label Alignment

Specifies how branch and tag reference labels are aligned for each commit.

• Setting: git-graph.referenceLabelAlignment
• Default: Normal
• Options:
  • Normal: Show branch & tag labels on the left of the commit message in the 'Description' column.
  • Branches (on the left) & Tags (on the right): Show branch labels on the left of the commit message in the 'Description' column, and tag labels on the right.
  • Branches (aligned to the graph) & Tags (on the right): Show branch labels aligned to the graph in the 'Graph' column, and tag labels on the right in the 'Description' column.

Retain Context When Hidden

Specifies if the Git Graph view Visual Studio Code context is kept when the panel is no longer visible (e.g. moved to background tab). Enabling this setting will make Git Graph load significantly faster when switching back to the Git Graph tab, however has a higher memory overhead.

• Setting: git-graph.retainContextWhenHidden
• Default: true
• Type: Boolean

Show Current Branch By Default

Show the current branch by default when Git Graph is opened. Default: false (show all branches)

• Setting: git-graph.showCurrentBranchByDefault
• Default: false
• Type: Boolean

Show Status Bar Item

Show a Status Bar item which opens Git Graph when clicked.

• Setting: git-graph.showStatusBarItem
• Default: true
• Type: Boolean

Show Uncommitted Changes

Show uncommitted changes (set to false to decrease load time on large repositories).

• Setting: git-graph.showUncommittedChanges
• Default: true
• Type: Boolean

Source Code Provider Integration Location

Specifies where the 'View Git Graph' action appears on the title of SCM Providers.

• Setting: git-graph.sourceCodeProviderIntegrationLocation
• Default: Inline
• Options:
  • Inline: Show the 'View Git Graph' action on the title of SCM Providers
  • More Actions: Show the 'View Git Graph' action in the 'More Actions...' menu on the title of SCM Providers

Tab Icon Colour Theme

Specifies the colour theme of the icon displayed on the Git Graph tab.

• Setting: git-graph.tabIconColourTheme
• Default: colour
• Options:
  • colour: Show a colour icon which suits most Visual Studio Code colour themes
  • 
  • grey: Show a grey icon which suits Visual Studio Code colour themes that are predominantly grayscale
  • 

Consumed Settings

This extension consumes the following settings:

Git: Path

Specifies the path of a portable Git installation.

• Setting: git.path
• Default: not set
• Type: String - File Path of the Git executable, for example C:\Program Files\Git\bin\git.exe on Windows