Article version:

Editing files in your repository

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

Tip: If a repository has any protected branches, you can't edit or upload files in the protected branch using the web interface.

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. Below the commit message fields, click the email address drop-down menu and choose a Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then <username> 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 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."

    Commit branch options

  8. Click Propose file change.

    Propose file change button

Further reading

Ask a human

Can't find what you're looking for?

Contact us