# How to Customize GitHub Profile

> To customize your GitHub profile, click your profile icon, select 'Your profile', and edit your README.md file. Then, customize your pinned repositories, click 'Edit profile' to add personal details, set a profile status using the emoji icon, and change your avatar by browsing files.

Canonical: https://livedemo.ai/tutorials/how-to-customize-github-profile/
Apps: GitHub
Updated: 2026-10-05
Interactive demo: https://story-api.livedemo.ai/workspaces/62255d3d3304f17b8f5e2d03/stories/692a3ab0ab56e05a00fe1cd8/preview?step=1

## Steps

1. Click your profile icon located at the right upper corner of your GitHub dashboard.
2. From the drop-down menu, select 'Your profile'.
3. Customize the README.FILE. The README.md file supports Markdown formatting, which allows you to add text, images, links, and more.
4. Click on the 'Customize your pins' to showcase your best repository in your profile.
5. You can edit pinned items by selecting more repositories that you want to pin.
6. Click 'Save pins' to complete the action.
7. Click 'Edit profile'.
8. Add your name, bio, pronouns or company and customize your profile how you want it to be.
9. Add your website, email and social accounts. Once done, click 'Save'.
10. Click the emoji icon to set a profile status.
11. Select a status and click 'Set status'.
12. You may also change your avatar. Just click on it and browse from your files.