This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-08-20. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Article version: Enterprise Server 2.18

Renaming a file

You can rename any file in your repositories directly in GitHub Enterprise. Renaming a file also gives you the opportunity to move the file to a new location.

Tips:

  • If you try to rename a file in a repository that you don’t have access to, we will fork the project to your user account and help you send a pull request to the original repository after you commit your change.
  • File names created via the web interface can only contain alphanumeric characters and hyphens (-). To use other characters, create and commit the files locally and then push them to the repository.
  • Some files, such as images, require that you rename them from the command line. For more information, see "Renaming a file using the command line."
  1. In your repository, browse to the file you want to rename.
  2. In the upper right corner of the file view, click to open the file editor.
    Edit file icon
  3. In the filename field, change the name of the file to the new filename you want. You can also update the contents of your file at the same time.
    Editing a file name
  4. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."
    Commit message for your change
  5. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."
    Commit branch options
  6. Click Propose file change.
    Propose file change button

Ask a human

Can't find what you're looking for?

Contact us