Cover image

How to Add a README to a GitHub Organization's Profile?

Posted on 10/28/2021


You may already know how to add a README to your GitHub profile (if you don't, have a look at this article), but did you know that you can also add one to an organization's profile?ย ๐Ÿค”

To do so, just head over to the GitHub organization you want to customize, and create a new repository named .github.

GitHub special repository

As you can see, GitHub already tells you that you discovered a special repository (once again ๐Ÿ˜›).

Make sure to set the repository's visibility to public.

From there, all you have to do is creating a profile/README.md file within this repository.

Editing the README.md file

We can then see the final result on the organization's GitHub homepage:

Final Result


Copyright ยฉ 2022 Ludovic CHOMBEAU