versioned_docs/version-1.25/usage/repository/profile-readme.md

---
date: "2023-03-02T21:00:00+05:00"
slug: "profile-readme"
sidebar_position: 42
---

# Profile READMEs

To display a Markdown file in your Gitea user or organization profile page, create a repository named `.profile` and add a new file named `README.md` to it.
Gitea will automatically display the contents of the file on your profile, in a new "Overview" above your repositories.

Making the `.profile` repository private will hide the Profile README.

Example of user with `.profile/README.md`:

![profile readme screenshot](/images/usage/profile-readme.png)
Add Gitea Profile Readmes (#23260 ) 2023-05-09 01:57:24 -04:00			`---`
			`date: "2023-03-02T21:00:00+05:00"`
			`slug: "profile-readme"`
Move usage directories (#300 ) 2025-11-20 19:49:24 +00:00			`sidebar_position: 42`
Add Gitea Profile Readmes (#23260 ) 2023-05-09 01:57:24 -04:00			`---`

Remove unnecessary usage prefix from doc titles (#24869 ) 2023-05-23 18:14:57 +08:00			`# Profile READMEs`
Add Gitea Profile Readmes (#23260 ) 2023-05-09 01:57:24 -04:00
Add Profile Readme for Organisations (#27955 ) 2023-11-09 15:05:52 +01:00			To display a Markdown file in your Gitea user or organization profile page, create a repository named `.profile` and add a new file named `README.md` to it.
			`Gitea will automatically display the contents of the file on your profile, in a new "Overview" above your repositories.`
Add Gitea Profile Readmes (#23260 ) 2023-05-09 01:57:24 -04:00
docs: Update Profile README information (#26947 ) 2023-09-06 14:22:50 +00:00			Making the `.profile` repository private will hide the Profile README.
Add screenshot for "Profile Readmes" to docs (#28964 ) 2024-01-28 00:20:17 +01:00
			Example of user with `.profile/README.md`:

Fix doc img path in profile readme (#28994 ) 2024-01-31 22:32:17 +09:00			`![profile readme screenshot](/images/usage/profile-readme.png)`