GitKraken Desktop Documentation

Edit and Save Files in GitKraken Desktop

Last updated: January 2026

Learn how to edit, save, and manage files using GitKraken Desktop’s built-in editor.


Enter Edit Mode Automatically

If you create a new file, GitKraken Desktop opens the file immediately in edit mode so you can begin editing right away.


Ways to Edit an Existing File

1. Use the Context Menu

Right-click a file (from a previous commit or via View all files) and select Edit file.

Right-click context menu showing the Edit file option for a selected file in GitKraken Desktop
Right-click any file and select Edit file.

2. Use the Command Palette

  1. Press Ctrl/Cmd + P
  2. Type Edit File and press Enter
  3. Type the filename and press Enter
Using the Command Palette in GitKraken Desktop to search for and select a file to edit
Find and open files using the Command Palette.

3. Use the Diff or File View

Click the button from a file diff.

GitKraken Desktop UI showing the Edit This File button enabled from Diff view
Click Edit this file from the Diff/File view panel.

Note: If viewing a file on a different branch, the button will read Edit in working directory. It opens the file version from your current branch.


File Edit Indicators

The upper-left corner of the file editor shows:

  • editable tag: Indicates the file can be modified
  • blue dot: Indicates unsaved changes
GitKraken Desktop file editor showing active editable mode with highlighted label
The file editor shows editable state.
GitKraken Desktop interface showing blue dot indicator for unsaved file edits
Unsaved changes are indicated with a blue dot.

Save or Discard Changes

  • Press Ctrl/Cmd + S to save
  • To discard unsaved changes:
    1. Hover over the blue dot
    2. Click the X
    3. Select Don't Save
GitKraken Desktop prompt asking whether to save or discard unsaved file changes
Prompt to discard unsaved changes.

Stage Your File Edits

After editing, click to commit your changes. Options include:

  • Save and stage
  • Stage saved changes only
GitKraken Desktop prompt asking to save and stage changes or only stage saved content when clicking Stage File
Save and stage or stage only saved changes.

File Encoding

GitKraken Desktop expects most files to use UTF-8 encoding. To review or adjust encoding:

  • Use the dropdown at the top of the editor
  • Visit Preferences > Encoding
  • Or select Guess Encoding to let GitKraken match it automatically
File editor in GitKraken Desktop showing encoding options including UTF-8, UTF-16LE, and Windows-1252
Encoding dropdown available from file editor.

Note: GitKraken Desktop does not change a file’s encoding upon save. Use an external editor like VS Code if you need to convert encodings.

Preferences panel in GitKraken Desktop showing a dropdown list of available default encodings including UTF-8 and ISO-8859 variants
Choose your default encoding from preferences.

Markdown Preview

GitKraken Desktop includes a built-in markdown preview for .md files. To access the option, first click to edit a file in the upper left of the file diff.

Diff view in GitKraken Desktop with the 'Edit This File' button highlighted in the top left panel
Click Edit this file from the Diff/File view panel.

From here, toggle the preview pane by clicking the button in the top of the editor.

Markdown file open in GitKraken Desktop with the Preview tab selected to show rendered output
Toggle the markdown preview when editing a file.

You can switch between editing and previewing the markdown content.

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