GitKraken Desktop Documentation

GitKraken Desktop Profiles | Manage Git Configs & Accounts

Last updated: January 2026


GitKraken Desktop uses profiles to manage app preferences, Tabs, and Git config settings. You can create and switch between profiles for different projects and environments.

Add Profile dialog in GitKraken showing selected avatar, profile name, author name, and email fields.
Set your email address to view your Gravatar preview.

Create and switch between multiple profiles with a GitKraken subscription.


Manage Profiles

GitKraken Preferences showing Profiles tab with profile details including name, author info, and organization.
Access profiles from Preferences > Profiles.

Enable Keep my .gitconfig updated with my profile info to sync your name and email with Git’s global .gitconfig.

What Does a Profile Store?

Each profile retains settings under:

  • Preferences > General
  • Preferences > Integrations
  • Preferences > UI Preferences

Tabs are also profile-specific. When you create a new profile, GitKraken Desktop will duplicate the tabs open in your current one.

User switching between GitKraken profiles, showing that each profile has its own independent set of tabs open.
Each profile maintains its own set of tabs.

Profiles support unique integration connections. For example, use separate profiles to connect different GitHub accounts.

List of three GitKraken profiles showing author names and emails, with notes indicating connection to different GitHub accounts for work and personal use.
Profiles can connect to different remote hosting accounts.

Change Profile Avatars

If connected to GitHub, GitHub Enterprise Server,GitLab, GitLab Self-Managed, Azure DevOps, or Bitbucket your avatar will match your GitHub profile. Otherwise, GitKraken Desktop uses the Gravatar linked to your profile’s email address.

To change your profile avatar:

  1. Click the profile icon in the top-right corner.
  2. Select Manage Profiles
Profile dropdown open in GitKraken with arrow pointing to 'Manage profiles' option.
Start from the profile image menu.
GitKraken Profiles Preferences with arrow pointing to 'Edit Profile' option for Default Profile.
Edit your profile details here.

Choose an icon or change the email address to use a different Gravatar image.

GitKraken profile editing screen showing the selected gravatar image and highlighted author email used to display it.
Set a different author email to change the profile Gravatar.

Author Initials in the Graph

Instead of avatars, display commit author initials in the commit graph:

GitKraken commit graph view showing commits with author initials instead of profile pictures
Display author initials instead of profile avatars.

To enable, go to Preferences > UI Preferences > Display author initials and generic remote icons instead of avatars.

Which Initials Are Used?

GitKraken Desktop uses initials based on the commit’s author name:

  • Commits made in GitKraken use profile name initials.
  • Commits from the CLI use initials from .git/config or .gitconfig.

Can Profiles Use Different Avatars?

Yes it can, if each profile has a unique email address linked to a different Gravatar. GitKraken currently does not support custom image uploads.

Have feedback about this article? Did we miss something? Let us know!
On this page