Article version: Enterprise Server 2.17
Moving a file to a new location
When editing a file, you can choose to move it anywhere within your repository, even if the directory doesn't exist.
In addition to changing the file location, you can also update the contents of your file, or give it a new name in the same commit.
Tips:
- If you try to move a file in a repository that you don’t have access to, we'll fork the project to your user account and help you send a pull request to the original repository after you commit your change.
- Some files, such as images, require that you move them from the command line. For more information, see "Moving a file to a new location using the command line".
- If a repository has any protected branches, you can't edit or upload files in the protected branch using GitHub. For more information, see “About protected branches."
You can use GitHub Desktop to move your changes to a new branch and commit them. For more information, see "Committing and reviewing changes to your project."
- In your repository, browse to the file you want to move.
- In the upper right corner of the file view, click to open the file editor.
- In the filename field, change the name of the file using these guidelines:
- To move the file into a subfolder, type the name of the folder you want, followed by
/
. Your new folder name becomes a new item in the navigation breadcrumbs. - To move the file into a directory above the file's current location, place your cursor at the beginning of the filename field, then either type
../
to jump up one full directory level, or type thebackspace
key to edit the parent folder's name.
- To move the file into a subfolder, type the name of the folder you want, followed by
- 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."
- 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
master
, 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." - Click Propose file change.