bugl
bugl
HomeLearnPatternsPathsSearchPremium
HomeLearnPatternsPaths
Learn/Git/Git Tutorial
Git•Git Tutorial

Git Stash

Key Commands for Stashing

  • git stash - Stash your changes
  • git stash push -m "message" - Stash with a message
  • git stash list - List all stashes
  • git stash branch <branchname> - Create a branch from a stash

What is Git Stash? Why Use It?

Sometimes you need to quickly switch tasks or fix a bug, but you're not ready to commit your work.

git stash lets you save your uncommitted changes and return to a clean working directory.

You can come back and restore your changes later.

Here are some common use cases

  • Switch branches safely: Save your work before changing branches.
  • Handle emergencies: Stash your work to fix something urgent, then restore it.
  • Keep your work-in-progress safe: Avoid messy commits or losing changes.

Stash Your Changes ( git stash )

Save your current changes (both staged and unstaged tracked files) with:

  • Tracked files (both staged and unstaged) are stashed by default.
  • Untracked files (new files not yet added to Git) are not stashed by default.
  • To stash untracked files too, use git stash -u (or --include-untracked ).

Example: Stash Your Work

git stash
Saved working directory and index state WIP on main: 1234567 Add new feature

This command saves your changes and cleans your working directory so you can safely switch tasks or branches.

Your changes are now saved in a stack.

What is a stash stack?

Each time you run git stash , your changes are saved on top of a "stack".

The most recent stash is on top, and you can apply or drop stashes from the top down, or pick a specific one from the list.

Your working directory is clean, and you can switch branches or pull updates safely.

Stash with a Message ( git stash push -m )

Add a message to remember what you stashed:

Example: Stash with a Message

git stash push -m "WIP: homepage redesign"
Saved working directory and index state On main: WIP: homepage redesign

This command lets you add a descriptive message to your stash so you can remember what you were working on.

Example: List Stashes

git stash list
stash@{0}: On main: WIP: homepage redesign
stash@{1}: WIP on main: 1234567 Add new feature

This command shows all the stashes you have saved so far, with their names and messages.

Show Stash Details ( git stash show )

See what was changed in the latest stash:

Example: Show Latest Stash

git stash show
 src/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

This command gives a summary of what files and changes are in your most recent stash.

Example: Show Full Diff

git stash show -p
diff --git a/src/index.html b/src/index.html
index 1234567..89abcde 100644
--- a/src/index.html
+++ b/src/index.html
@@ ...

This command shows the exact lines that were changed in your most recent stash.

Apply the Latest Stash ( git stash apply )

Restore your most recent stashed changes (keeps the stash in the stack):

Example: Apply Latest Stash

git stash apply
On branch main
Changes not staged for commit:
 (use "git add <file>..." to update what will be committed)
 (use "git restore <file>..." to discard changes in working directory)
 modified: src/index.html

This command restores your most recent stashed changes, but keeps the stash in the list so you can use it again if needed.

Apply a Specific Stash ( git stash apply stash@{n} )

Restore a specific stash from the list:

Example: Apply a Specific Stash

git stash apply stash@{1}
On branch main
Changes not staged for commit:
 modified: src/index.html

This command lets you restore a specific stash from your list, not just the most recent one.

Pop the Stash ( git stash pop )

Apply the latest stash and remove it from the stack :

Example: Pop the Stash

git stash pop
On branch main
Changes not staged for commit:
 modified: src/index.html
Dropped refs/stash@{0} (abc1234d5678)

This command restores your most recent stash and removes it from the list at the same time.

Drop a Stash ( git stash drop )

Delete a specific stash when you no longer need it:

Example: Drop a Stash

git stash drop stash@{0}
Dropped stash@{0} (abc1234d5678)

This command deletes a specific stash from your list when you no longer need it.

  • Clear All Stashes ( git stash clear )

Example: Clear All Stashes

git stash clear

This command deletes all your stashes at once. Be careful! This cannot be undone!

Branch from a Stash ( git stash branch )

Create a new branch and apply a stash to it.

Useful if your stashed work should become its own feature branch:

Example: Branch from a Stash

git stash branch new-feature stash@{0}
Switched to a new branch 'new-feature'
On branch new-feature
Changes not staged for commit:
 modified: src/index.html
Dropped stash@{0} (abc1234d5678)

This command creates a new branch and applies your stashed changes to it.

This is useful if you decide your work should become its own feature branch.

Best Practices for Stashing

  • Use clear messages when stashing: git stash push -m "WIP: feature name"
  • Don't use stashes as long-term storage-commit your work when possible.
  • Check your stash list regularly and clean up old stashes you no longer need.

Troubleshooting

  • Did you lose your changes? Try git stash list and git stash apply to recover stashed work.
  • Stash didn't apply cleanly? You may need to resolve conflicts, just like a merge. Git will mark the conflicts in your files for you to resolve.
  • Untracked files missing? By default, untracked files are not stashed. If you need to stash them, use git stash -u next time.
  • Accidentally cleared all stashes? Unfortunately, git stash clear is permanent. Always double-check before running it!

Note

Stashes are useful for temporary work, but are not a replacement for commits!

Previous

Git Tagging

Next

Git History

This chapter

Overview
17

Lessons

79m

Read time

1. Git Tutorial2. Git and GitHub Introduction3. Git Install4. Git Config5. Git Getting Started6. Git New Files7. Git Staging Environment8. Git Commit9. Git Tagging10. Git Stash11. Git History12. Git Help13. Git Branch14. Git Branch Merge15. Git Workflow16. Git Best Practices17. Git Glossary

On this page

Key Commands for StashingWhat is Git Stash? Why Use It?Stash Your Changes ( git stash )Example: Stash Your WorkStash with a Message ( git stash push -m )Example: Stash with a MessageExample: List StashesShow Stash Details ( git stash show )Example: Show Latest StashExample: Show Full DiffApply the Latest Stash ( git stash apply )Example: Apply Latest StashApply a Specific Stash ( git stash apply stash@{n} )Example: Apply a Specific StashPop the Stash ( git stash pop )Example: Pop the StashDrop a Stash ( git stash drop )Example: Drop a StashExample: Clear All StashesBranch from a Stash ( git stash branch )Example: Branch from a StashBest Practices for StashingTroubleshooting