Skip to main content

Customizing your organization's profile

You can share information about your organization by customizing your organization's profile.

About your organization's profile page

You can share information about how to engage with your organization by creating an organization profile README for both public users and members of the organization. GitHub shows your organization profile README in the "Overview" tab of your organization.

You can choose what information to include in your organization profile README. Here are some examples of information that may be helpful.

  • An "About" section that describes your organization
  • Guidance for getting help in the organization

You can format text and include emoji, images, and GIFs in your organization profile README by using GitHub Flavored Markdown. For more information, see "Getting started with writing and formatting on GitHub."

Adding a public organization profile README

  1. If your organization does not already have a public .github repository, create a public .github repository.

  2. In your organization's .github repository, create a README.md file in the profile folder.

  3. Commit the changes to the README.md file. The content of the README.md will appear on your organization's public profile.

    Image of an organization's public README