docs/content/github/managing-files-in-a-repository/managing-files-using-the-command-line/renaming-a-file-using-the-command-line.md

title, intro, redirect_from, versions, topics, shortTitle

title	intro	redirect_from	versions	topics	shortTitle
Renaming a file using the command line	You can use the command line to rename any file in your repository.	/articles/renaming-a-file-using-the-command-line /github/managing-files-in-a-repository/renaming-a-file-using-the-command-line	fpt ghes ghae * * *	Repositories	Rename a file locally

Many files can be renamed directly on {% data variables.product.product_name %}, but some files, such as images, require that you rename them from the command line.

{% data reusables.command_line.manipulating_file_prereqs %}

{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.command_line.switching_directories_procedural %} 3. Rename the file, specifying the old file name and the new name you'd like to give the file. This will stage your change for commit.

$ git mv <em>old_filename</em> <em>new_filename</em>

4. Use git status to check the old and new file names.

$ git status
> # On branch <em>your-branch</em>
> # Changes to be committed:
> #   (use "git reset HEAD <file>..." to unstage)
> #
> #     renamed: <em>old_filename</em> -> <em>new_filename</em>
> #

{% data reusables.git.commit-file %}

$ git commit -m "Rename file"
# Commits the tracked changes and prepares them to be pushed to a remote repository.
# {% data reusables.git.reset-head-to-previous-commit-codeblock %}

{% data reusables.git.git-push %}

Further reading

• "Moving a file to a new location using the command line"
• "Adding a file to a repository using the command line"