Undo & History

How to Unstage Files from Git (Undo git add)

Remove files from the Git staging area (index) without losing any of your local changes.

Instant 1-Line Solution

Safe CommandBeginner

git restore --staged <file>

When to use this scenario:You accidentally ran "git add ." and included sensitive files (like .env or large build binaries) you didn't intend to commit.

Step-by-Step Execution Guide

1Unstage a single specific file

git restore --staged <file-path>

Removes the file from index; your changes remain safe in your working directory.

2Unstage all staged files at once

git restore --staged .

Clears the entire staging area back to unstaged modified state.

Critical Pitfalls & Precautions

•Do NOT confuse "git restore --staged <file>" with "git restore <file>". Omitting "--staged" will permanently wipe your changes!

Frequently Asked Questions

Unstage Files (Undo git add) - Frequently Asked Questions

Common questions about safe rollback, remote history implications, and troubleshooting.

Older Git versions used "git reset HEAD <file>". Both achieve the same result, but "git restore --staged" is the clearer modern syntax.

Related Git Command Guides

Browse All Git Recipes

Undo & HistorySafe

How to Undo the Last Commit in Git

Undo your most recent Git commit while keeping all your edited files staged or unstaged in your working directory.

Undo & HistoryDestructive

How to Discard All Local Changes in Git

Discard all unstaged and uncommitted file modifications and restore your working tree to the latest commit.

Branches & TagsSafe

How to Rename a Local and Remote Git Branch

Rename your current local branch and update the upstream remote tracking branch on GitHub or GitLab.

Branches & TagsReversible

How to Delete a Remote Branch in Git

Delete a branch from remote origin (GitHub, GitLab, Bitbucket) after a pull request has been merged.

Undo & HistorySafe

How to Change the Most Recent Git Commit Message

Amend the commit message of your latest commit before or after pushing.

Stash & CleanSafe

How to Stash Untracked and Modified Files in Git

Temporarily shelve both modified and newly created untracked files to switch branches with a clean working copy.