x
Back to Blogs
May 7, 2026

Adding Verified Tag to GitHub Commits

Have you ever wondered why does your commit on GitHub shows “Unverified” instead of “Verified”?

Unverified Commit

Wouldn’t it be great if you could add a verified tag to your commits, showing that they are authentic and trustworthy?

Verified Commit

Adding a verified tag to your GitHub commits enhances credibility and helps users trust the authenticity of your contributions. In this post, we will explore how to add a verified tag to your GitHub commits using SSH keys.

What is a Verified Commit?#

A verified commit is a commit that has been signed with a GPG key or an SSH key, indicating that the commit was made by a trusted source. This is particularly important in open-source projects where multiple contributors are involved.

Methods:#

  1. Using GPG Keys: This method involves generating a GPG key and configuring Git to use it for signing commits. It provides a high level of security and is widely supported.

  2. Using SSH Keys: This method allows you to sign commits using your SSH key, which is often more convenient for developers who already use SSH for authentication with GitHub.

Using SSH Keys to Sign Commits

In this post, we will focus on how to use SSH keys to sign your commits.

Step 1: Generate an SSH Key (if you don’t have one)

ssh-keygen -t ed25519 -C "[email protected]"

This command will generate a new SSH key pair. Follow the prompts to save the key and set a passphrase if desired. You can also modify the file name and type of key if you prefer a different configuration.

Step 2: Add Your SSH Key to GitHub

  1. Copy the contents of your public SSH key (usually found at ~/.ssh/id_ed25519.pub).
cat ~/.ssh/id_ed25519.pub
  1. Go to GitHub > Profile Icon > Settings > SSH and GPG keys > New SSH key.

GitHub SSH Key Settings

  1. In the “Title” field, add a descriptive name for the key (e.g., “My Laptop SSH Key”).
  2. For the “Key Type”, select “Signing Key”.
  3. Paste the contents of your public SSH key into the “Key” field.
  4. Click “Add SSH key”.

GitHub Add SSH Key

Step 3: Configure Git to Use Your SSH Key for Signing

  1. Tell Git that you want to use SSH keys for signing commits:
git config --global gpg.format ssh
  1. Set your SSH key as the default signing key:
git config --global user.signingkey ~/.ssh/id_ed25519
  1. Enable commit signing by default:
git config --global commit.gpgsign true

(Optional) If you want to sign commits only for a specific repository, navigate to that repository and run the above commands without the --global flag. This is neccessary if you have multiple github accounts setup on the same machine and want to use different SSH keys for each account.

Step 4: Make a Signed Commit

git commit -S -m "Your commit message"

or simply:

git commit -m "Your commit message"

Step 5: Verify the Commit on GitHub

After pushing your commit to GitHub, you should see a “Verified” badge next to your commit in the repository’s commit history.

Conclusion#

Adding a verified tag to your GitHub commits using SSH keys is a straightforward process that enhances the credibility of your contributions. By following the steps outlined above, you can ensure that your commits are trusted and recognized as authentic by the GitHub community.

Related