Guide · Brag document
How to write a brag document that gets read.
A brag document is a running record of what you've done and why it mattered. It turns reviews, raises and client pitches from guesswork into a list you already have.
Updated
What is a brag document?
A brag document, also called a brag sheet, is a private list of your accomplishments, written as you go rather than recalled at review time. Julia Evans popularised it for software engineers in her post Get your work recognized: write a brag document, and the idea has spread well beyond engineering.
The point isn’t to boast. It’s that nobody, including you, remembers in December what happened in March.
Why it’s worth ten minutes a week
- Reviews. Your manager writes your review from memory too. A list gives them the evidence.
- Raises and promotions. Asking for more is easier with a page of results in front of you.
- Client pitches and rate increases. Past results are the strongest case for your next client and your next rate.
- Your CV. When you change jobs, the bullet points are already written.
What to include
- What you did. One line, in plain words.
- The result. What changed because of it. Numbers beat adjectives: time saved, money made, errors cut, people helped.
- Who it was for. The team, client or project.
- The less visible work. Mentoring, reviews, documentation, fixing the thing everyone worked around. It counts, and it’s the first thing forgotten.
- What people said. A line of praise from a client or colleague, copied word for word.
Examples: before and after
Most first drafts describe activity. Rewrite each line until it describes a result.
| Before | After |
|---|---|
| Worked on the checkout redesign. | Shipped the new checkout. Conversions rose 18% in the first week, about $40k more a month. |
| Helped with onboarding. | Mentored two new hires through their first release. Both shipped on time, with no rollbacks. |
| Did an audit for Northwind. | Turned a one-off audit for Northwind into a six-month, $12k retainer. |
| Looked into cloud costs. | Moved image processing to a queue and cut the cloud bill by a third, saving $2,100 a month. |
How often to update it
Weekly works best. On Friday, while the week is fresh, go through what you finished and keep the parts that mattered. Monthly is fine if weekly won’t stick, but details fade fast.
Don’t wait for review season. By then the numbers are gone, and only the last month comes to mind.
A simple template
Copy this into any doc and replace the examples with your own.
## March - Shipped the new checkout (Acme Store) Result: conversions up 18% in the first week, about $40k a month. Feedback: "Smoothest launch we've had." (Head of Product) - Mentored two new hires to their first release (Platform team) Result: both shipped on time, with no rollbacks. - Wrote the on-call runbook nobody had time for Result: pages resolved without escalation went from rare to routine.
Or let your finished work fill it in
In Jottaware, the brag sheet is built from the tasks you already track. Finish a task, star it, and it moves to your brag sheet. Add a line about why it mattered. On Fridays, when you’ve finished something, an email lists that week’s work so you can star it while it’s fresh. At review time, copy the whole sheet as text.
Try it below. Tap a star.
Brag sheet
Star your milestones.
Keep them in your brag sheet.
Shipped the new checkout
Acme Store · WedTurned an audit into a $12k retainer
Northwind · ThuCut the cloud bill by a third
Acme Store · TueMentored two new hires to their first release
Platform team · Fri
November 2026
Led the move to the new billing system
Acme Store · MonZero downtime for 30,000 customers, and a week ahead of schedule.
Questions people ask
Is a brag document the same as a brag sheet?
Yes. Brag document, brag sheet and brag file all mean the same thing: a running list of your wins and the difference they made.
Should I share my brag document with my manager?
Yes, before your review. It saves your manager reconstructing your year from memory. Share a tidy version and keep the raw list for yourself.
What if my work is hard to measure?
Describe the result instead of a number: what became possible, faster or less painful. “The support team stopped escalating billing questions” is still a result.
Is a brag document useful for freelancers?
Very. It becomes case studies for your portfolio, evidence for a rate increase, and a record of which clients you did your best work for.
Start your brag sheet this Friday.
Track your work in Jottaware and star what mattered. Your brag sheet builds itself, week by week. Free for 14 days, no card needed.
Start your free trial