Editing files

You can edit files directly on GitHub in any of your repositories using the file editor.

Editing files in your repository

Tip: 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."

Note: GitHub's file editor uses CodeMirror.

  1. In your repository, browse to the file you want to edit.

  2. In the upper right corner of the file view, click to open the file editor. Edit file button

  3. On the Edit file tab, make any changes you need to the file. New content in file

  4. Above the new content, click Preview changes. File preview button

  5. 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

  6. If you have more than one email address associated with your account on GitHub.com, click the email address drop-down menu and select the email address to use as the Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then <username>@users.noreply.github.com is the default commit author email address. For more information, see "Setting your commit email address." Choose commit email addresses

  7. 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

  8. Click Propose file change. Propose file change button

Editing files in another user's repository

When you edit a file in another user's repository, we'll automatically fork the repository and open a pull request for you.

  1. In another user's repository, browse to the folder that contains the file you want to edit. Click the name of the file you want to edit.

  2. Above the file content, click . At this point, GitHub forks the repository for you.

  3. Make any changes you need to the file. New content in file

  4. Above the new content, click Preview changes. File preview button

  5. 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

  6. If you have more than one email address associated with your account on GitHub.com, click the email address drop-down menu and select the email address to use as the Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then <username>@users.noreply.github.com is the default commit author email address. For more information, see "Setting your commit email address." Choose commit email addresses

  7. Click Propose file change. Commit Changes button

  8. Type a title and description for your pull request. Pull Request description page

  9. Click Create pull request. Pull Request button

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.