GitKraken Desktop Documentation

Interactive Rebase in GitKraken Desktop

Last updated: March 2026

Use this page to run interactive rebase in GitKraken Desktop when you need to reorder, combine, rename, or drop commits before sharing or merging a branch. It explains how to start the rebase, what the available actions do, and which branch and history conditions must be met before the workflow is available.

Requirements and limits

  • Workflow scope: Rewrite local branch history before sharing or merging
  • Required branch condition: Branches must share a common ancestor
  • Rebase limitation: Interactive rebase is not available for merge commits
  • Source-branch limitation: No merge commits may exist on the source branch
  • Initial-commit limitation: Neither branch may include the repository’s initial commit for this workflow
  • Tooling limitation: If you start the rebase in GitKraken Desktop, you must complete it there

Quick Start

To start interactive rebase:

  • Drag and drop a branch onto a target branch and select Interactive Rebase.
  • Or right-click a target branch in the Left Panel and choose Interactive Rebase.
  • Or right-click any parent commit in the graph and select the option.

Available commit actions:

  • Pick: Keep the commit as-is.
  • Reword: Edit the commit message.
  • Squash: Combine the commit into its parent commit.
  • Drop: Remove the commit from history entirely.

Keyboard shortcuts in the rebase view: P = Pick, S = Squash, R = Reword, D = Drop.

To undo all changes before confirming, click Reset. Interactive rebase requires that branches share a common ancestor and that no merge commits exist on the source branch. If you start the rebase in GitKraken Desktop, you must complete it there.


How to start an interactive rebase

To begin:

  • Drag and drop one branch onto another
  • Or right-click a target branch and select Interactive Rebase
Interactive rebase initiated in GitKraken Desktop by dragging one branch onto another, revealing options including 'Interactive Rebase'
Start interactive rebase via drag-and-drop or right-click

You can also right-click any parent commit to access the option. Note: Interactive rebase is not available for merge commits.

Interactive rebase requirements

Interactive rebase is available only if:

  • The branches share a common ancestor
  • No merge commits exist on the source branch
  • Neither branch includes the repo’s initial commit
  • You’re not trying to rebase a parent onto a child (e.g., main onto feature)

Note: If you start the rebase in GitKraken Desktop, you must complete it there.


What the interactive rebase actions do

How Pick works

Moves the commit onto the target branch as-is.

Interactive rebase in GitKraken Desktop using the 'Pick' action to include each commit as-is
Pick applies the commit without modifications

How Reword works

Opens a modal to edit the commit summary and description.

Interactive rebase in GitKraken Desktop showing the reword option and message editor for updating a commit message
Reword lets you update the commit message

How Squash works

Combines the selected commit into its parent.

Interactive rebase in GitKraken Desktop showing Squash selected for two commits, which will combine into a single commit
Squash merges the commit into the one above

How Drop works

Removes the commit entirely and rewrites the graph.

Interactive rebase in GitKraken Desktop with one commit marked as Drop, which will remove it from history
Drop deletes the commit from history

How shortcuts and Reset work

Use these keyboard shortcuts during rebase:

  • P: Pick
  • S: Squash
  • R: Reword
  • D: Drop

To undo all changes during setup, click .

Interactive rebase in GitKraken Desktop showing a user clicking the Reset button to undo changes and restart the rebase process
Use Reset to cancel changes and start over
Have feedback about this article? Did we miss something? Let us know!
On this page