Skip to main content

About your profile

Your profile page tells people your story through the information you share, the contributions you make, and the projects you showcase.

You can tell other people a little bit about yourself by writing a bio. With the help of @mentions and emoji, you can include information about where you currently or have previously worked, what type of work you do, or even what kind of coffee you drink. The bio field is limited to 160 characters.

For a longer-form and more prominent way of displaying customized information about yourself, you can create a profile README. If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page.

If you have the activity overview section enabled for your profile and you @mention an organization you're a member of in your profile bio, then that organization will be featured first in your activity overview.

Screenshot of the profile page for @octocato. In the top-right corner, a profile README greets the viewer and lists information about the user's work.

People who visit your profile can also see:

  • A timeline of your contribution activity, like issues and pull requests you've opened, commits you've made, and pull requests you've reviewed
  • Repositories and gists you own or contribute to. You can showcase your best work by pinning repositories and gists to your profile.
  • Repositories you've starred and organized into lists
  • An overview of your activity in organizations, repositories, and teams you're most active in
  • Badges and Achievements that highlight your activity and show if you use GitHub Pro or participate in programs like the Arctic Code Vault, GitHub Sponsors, or the GitHub Developer Program
  • Your pronouns (if you have set them)
  • Mutual connections, including people both you and the viewer follow
  • Your status message sharing information about your availability (if you have set one)

Next steps

To start customizing your profile, see Personalize your profile and Managing your profile README.