GitHub recently released a feature that allows users to create a profile-level README to showcase. This article walksthrough how to access this new feature.
Why READMEs?
The GitHub profile-level README feature allows more content than the profile bio, the README is significantally more visible as it is placed above pinned repositories and supports markdown which means you can play around with the content more visually.
A solid README is a core-component of well-documented software and often encourages collaboration by sharing helpful context with contributors.
I'm getting the error message because I have already created one.
How do I create a profile README?
Step 1: Creating a new repository thatβs the same name(including casing) as your username.
For example, my GitHub username is ayushi7rawat so I created a new repository with the name ayushi7rawatStep 2: Create a README.md file and add your fancy code there
Step 3: Once done you can Commit your new README!
What if you already have a repository with the same name? Iβd recommend renaming the existing project, or if possible, changing the content of the README file.
My profile README is relatively simple. You can see how it looks like by checking my GitHub profile.
Quick Reference and Cheatsheet
Add Profile views counter
You can just simply add this code inside your README.

Have you created yours?
I shared mine, now you can share yours with me at Twitter
If you have any Queries or Suggestions, please reach out to me in the Comments Section below.
Also, have look at my other blogs:
Discussion (3)
Hi, There is a GitHub Readme Card and I think you'll be interested in it.
Sure, I will check it out.
Thank you Abser.
Tired of updating GitHub profile README with the latest features again & again?
If yes, then I have developed a tool to do the same for you in just 1 click π€
π Try the tool: live tool
If you find the tool useful, show some love by giving a β on βοΈ repo
π Generate GitHub profile README easily with the latest add-ons like visitors count, GitHub stats, etc using minimal UI.
GitHub Profile README Generator
View Demo Β· Report Bug Β· Request Feature
Loved the tool? Please consider donatingπΈ to help it improve!
Try the tool: GitHub Profile README Generator
Just fill in the details such as
Name
,Tagline
,Dev Platforms Username
,Current Work
,Portfolio
,Blog
, etc. with a minimal UI.Uniform Dev Icons
Uniform Social Icons
Visitors Counter Badge
GitHub Profile Stats Card
GitHub Top Skills
GitHub Streak Stats
Dynamic Dev(.)to Blogs (GitHub Action)
Dynamic Medium Blogs (GitHub Action)
Dynamic Personal Blogs from RSS Feed (GitHub Action)
Wakatime Stats contribute
Buy Me A Coffee button
Click on
Generate README
to get your README inmarkdown
β¦