forgejo-docs/docs/user/profile.md

---
title: 'Profile customization'
license: 'Apache-2.0'
origin_url: 'https://github.com/go-gitea/gitea/blob/faa28b5a44912f1c63afddab9396bae9e6fe061c/docs/content/doc/usage/profile-readme.en-us.md'
---

By default the profile page of a user is the list of repositories they
own. It is possible to customize it with a short description that
shows to the left, under their avatar. It can now be fully
personalized with a markdown file that is displayed instead of the
list of repositories.

![Profile page](../../../../images/v1.21/user/profile/profile-step1.png)

It uses the `README.md` file from the `.profile` repository of the
user, if it exists.

![Profile README.md](../../../../images/v1.21/user/profile/profile-step2.png)

> **NOTE:** if a the `.profile` repository is private the `README.md` they contain will be displayed publicly. It is **strongly recommended** to verify no such repository exist in a given instance before upgrading.
docs: user: profile: document user custom profiles # Conflicts: # user/profile.md 2023-07-24 11:21:31 -04:00			`---`
			`title: 'Profile customization'`
			`license: 'Apache-2.0'`
			`origin_url: 'https://github.com/go-gitea/gitea/blob/faa28b5a44912f1c63afddab9396bae9e6fe061c/docs/content/doc/usage/profile-readme.en-us.md'`
			`---`

			`By default the profile page of a user is the list of repositories they`
			`own. It is possible to customize it with a short description that`
			`shows to the left, under their avatar. It can now be fully`
			`personalized with a markdown file that is displayed instead of the`
			`list of repositories.`

Create v1.21 documentation A verbatim copy of the v1.20 documentation to build upon. With just a replacement of v1.20 with v1.21 where relevant. 2023-08-09 16:32:54 -04:00			`![Profile page](../../../../images/v1.21/user/profile/profile-step1.png)`
docs: user: profile: document user custom profiles # Conflicts: # user/profile.md 2023-07-24 11:21:31 -04:00
			It uses the `README.md` file from the `.profile` repository of the
			`user, if it exists.`

Create v1.21 documentation A verbatim copy of the v1.20 documentation to build upon. With just a replacement of v1.20 with v1.21 where relevant. 2023-08-09 16:32:54 -04:00			`![Profile README.md](../../../../images/v1.21/user/profile/profile-step2.png)`
docs: user: profile: document user custom profiles # Conflicts: # user/profile.md 2023-07-24 11:21:31 -04:00
			> NOTE: if a the `.profile` repository is private the `README.md` they contain will be displayed publicly. It is strongly recommended to verify no such repository exist in a given instance before upgrading.