Git - File Status


The status of a file in a working directory is one of:

Git File Lifecycle


State Tracked Description
untracked untracked New file
unmodified Tracked File is the same as in the last commit
modified Tracked File is not the same as in the last commit
staged Tracked File has been added in the index to create the next commit

Tracked / Untracked

Each file in a working directory can be in one of two states:


Tracked files are files that were in the last snapshot (ie head). They can have the status:

  • unmodified,
  • modified,
  • or staged (ie in the index for the next commit)


Untracked files are new files.

More specifically, they are any files in the working directory that:




git status
On branch master
Your branch is up-to-date with 'origin/master'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   syntax.php

no changes added to commit (use "git add" and/or "git commit -a")

Discover More
Git - Add command (Staging) - Add a change to the next commit

Add file contents to the staging area (known also as the index). This statement will add all files and any new untracked files.
Git - File

File management in Git (blob and not directory) blob object on the local file system or not (ie in the git file system database) See and short status A file (or blob) identifier is the...
Git - Getting Started

An article that takes the basic steps in order to set up a Git repository When you want to set up a repository, you face generally two options: you want to create a fresh install from a Git repository...
Git - Git (executable|command line)

The git executable where: --git-dir is the location of the repository files --work-tree is the location of the work tree Command Description add Add file contents to the index add--interactive...
What are short status ?

short status is a one letter that summarize the file status Added (A), Copied (C), Deleted (D), Modified (M), Renamed (R), have their type (i.e. regular file, symlink, submodule, …)...
What is a Git Checkout?

With a checkout, you can change the current branch (ie switch branches) or extract files/directory from branches into the working tree (file system directory) files. ie: Restore the file state from...
What is the Git Working Tree? or working Area

The working tree (or working area) is a directory where the work happens (extraction, modification, commit). It's on the local file system: a directory where the files of the git repository have been...

Share this page:
Follow us:
Task Runner