How to Delete a File From a Git Repository?

Last Updated : 23 Jul, 2025

Managing files within a Git repository often involves adding new files, modifying existing ones, and sometimes, deleting files that are no longer needed. Deleting a file from a Git repository is a simple process, but it's essential to follow the correct steps to ensure that the repository remains consistent and version history is preserved. This article will guide you through the process of deleting a file from a Git repository.

Prerequisites

Before you begin, ensure you have the following:

  • Git Installed: Make sure Git is installed on your system. You can download it from Git's official website.
  • Access to the Repository: Ensure you have access to the repository where you need to delete a file.
  • Basic Git Knowledge: Familiarity with basic Git commands and workflows.

Steps to Delete a File from a Git Repository

Step 1: Navigate to Your Repository

Open your terminal or command prompt and navigate to the local directory of your Git repository using the cd command. For example:

cd path/to/your/repository

Step 2: Delete the File

Use the git rm command followed by the file path to remove the file from your repository. This command stages the deletion, so you need to commit the change afterward.

git rm path/to/your/file.txt

Step 3: Commit the Change

After staging the file deletion, commit the change to your repository with an appropriate commit message.

git commit -m "Delete file.txt as it is no longer needed"

Step 4: Push the Change to the Remote Repository

Finally, push the committed change to the remote repository to update it.

git push origin main

Replace main with the name of your branch if you are working on a different branch.

Example

Let's walk through an example. Suppose you have a file named obsolete.txt in your repository that you want to delete.

Step 1: Navigate to the Repository:

cd ~/projects/my-repo

Step 2: Remove the File:

git rm file1

Step 3: Commit the Deletion:

git commit -m "Remove file1 as it is no longer needed"

Step 4: Push the Change:

git push origin main
ss
How to Delete a File From a Git Repository?

Additional Tips

  • Force Deletion: If you want to delete a file without staging it first, you can use the -f or --force flag with git rm:
git rm -f path/to/your/file.txt
  • Remove Files from Index but Keep Locally: If you want to remove the file from the repository but keep it in your local working directory, use the --cached option:
git rm --cached path/to/your/file.txt
  • Remove Multiple Files: You can delete multiple files at once by listing them:
git rm file1.txt file2.txt
  • Interactive Mode: Use git rm -i to enter an interactive mode where you can selectively remove files.
Comment

Explore