forgejo-docs/docs/user/profile.md

---
title: 'Profile customization'
license: 'Apache-2.0'
origin_url: 'https://github.com/go-gitea/gitea/blob/abe8fe352711601fbcd24bf4505f7e0b81a93c5d/docs/content/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/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/user/profile/profile-step2.png)

Making the `.profile` repository private will hide the Profile README.
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'`
sync with Gitea abe8fe352711601fbcd24bf4505f7e0b81a93c5d git diff bd4c7ce578956d9839309b16753bd5505b63b2e3..abe8fe352711601fbcd24bf4505f7e0b81a93c5d -- $(find . -type f -name 'en-us') (cherry picked from commit 0b81e66c45cc6a7a24306a948707e8ee01361876) 2023-10-08 09:11:22 -04:00			`origin_url: 'https://github.com/go-gitea/gitea/blob/abe8fe352711601fbcd24bf4505f7e0b81a93c5d/docs/content/usage/profile-readme.en-us.md'`
docs: user: profile: document user custom profiles # Conflicts: # user/profile.md 2023-07-24 11:21:31 -04:00			`---`

			`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.`

move images to content dir and use relative paths This is necessary for the website upgrade to Astro v3, which has a new built-in image API. 2023-08-30 20:08:10 -04:00			`![Profile page](../_images/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.`

move images to content dir and use relative paths This is necessary for the website upgrade to Astro v3, which has a new built-in image API. 2023-08-30 20:08:10 -04:00			`![Profile README.md](../_images/user/profile/profile-step2.png)`
docs: user: profile: document user custom profiles # Conflicts: # user/profile.md 2023-07-24 11:21:31 -04:00
sync with Gitea abe8fe352711601fbcd24bf4505f7e0b81a93c5d git diff bd4c7ce578956d9839309b16753bd5505b63b2e3..abe8fe352711601fbcd24bf4505f7e0b81a93c5d -- $(find . -type f -name 'en-us') (cherry picked from commit 0b81e66c45cc6a7a24306a948707e8ee01361876) 2023-10-08 09:11:22 -04:00			Making the `.profile` repository private will hide the Profile README.