Skip to content

Extension Settings

Michael Hutchison edited this page May 15, 2019 · 35 revisions

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

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

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

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
Graph Style - Rounded Graph Style - 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

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.

Status Bar Item

  • 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

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
    • Tab Icon Colour Theme - Colour
    • grey: Show a grey icon which suits Visual Studio Code colour themes that are predominantly grayscale
    • Tab Icon Colour Theme - Grey

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

General Information:

Release Information:

Contributing Information:

If you have any questions about Git Graph, please chat with us on Discord!

Clone this wiki locally