You can attribute a commit to more than one author by adding one or more Co-authored-by trailers to the commit's message. Co-authored commits are visible on GitHub Enterprise and can be included in the profile contributions graph and the repository's statistics.

Required co-author information

Before you can add a co-author to a commit, you must know the appropriate email to use for each co-author. For the co-author's commit to count as a contribution, you must use the email associated with their GitHub Enterprise account.

Creating co-authored commits on the command line

  1. Collect the name and email address for each co-author.

  2. Type your commit message and a short, meaningful description of your changes. After your commit description, instead of a closing quotation, add two empty lines.

    git commit -m "Refactor usability tests.
    >
    >
    

    Tip: If you're using a text editor on the command line to type your commit message, ensure there are two lines between the end of your commit description and the Co-authored-by: commit trailer.

  3. On the next line of the commit message, type Co-authored-by: name <name@example.com> with specific information for each co-author. After the co-author information, add a closing quotation mark.

    If you're adding multiple co-authors, give each co-author their own line and Co-authored-by: commit trailer.

    git commit -m "Refactor usability tests.
    >
    >
    Co-authored-by: name <name@example.com>
    Co-authored-by: another-name <another-name@example.com>"
    

The new commit and message will appear on your GitHub Enterprise instance the next time you push. For more information, see "Pushing to a remote."

Creating co-authored commits on GitHub Enterprise

After you've made changes in a file using the web editor on GitHub Enterprise, you can create a co-authored commit by adding a Co-authored-by: trailer to the commit's message.

  1. Collect the name and email address for each co-author.

  2. After making your changes together, at the bottom of the page, type a short, meaningful commit message that describes the changes you made. Commit message for your change

  3. In the text box below your commit message, add Co-authored-by: name <name@example.com> with specific information for each co-author. If you're adding multiple co-authors, give each co-author their own line and Co-authored-by: commit trailer.

    Commit message co-author trailer example in second commit message text box

  4. Click Commit changes or Propose changes.

The new commit and message will appear on your GitHub Enterprise instance.

Further reading