Skip to main content

Creating a README for an enterprise

You can create a README to tell your members what is happening in your enterprise.

Who can use this feature?

Enterprise owners can create and edit an enterprise README.

About READMEs for enterprises

To help people understand what is happening in your enterprise, you should create a README. For example, you can use a README to help members learn about different organizations in the enterprise, to share links to important resources, or to communicate information about the settings and policies of your enterprise.

The README is displayed on the enterprise's "Overview" page, which is the page you see when you navigate to the enterprise at This page is only visible to members of the enterprise.

You can also create READMEs for organizations in your enterprise, visible either publicly or only to members. For more information, see "Customizing your organization's profile."

Creating a README for an enterprise

  1. In the top-right corner of GitHub, click your profile photo, then click Your enterprises.

  2. In the list of enterprises, click the enterprise you want to view.

  3. On the "Overview" page, click Create README. If a README is already present on the page, click Edit.

  4. Write the content for your README. You can use Markdown to format the content, such as adding headings, images, and lists. For more information, see "Basic writing and formatting syntax."


    You can only link to publicly hosted images in your README. You cannot upload an image to your README, or link to an image from a private repository.

  5. Click Save.

Further reading