5 min read
On this page

Raises & Promotions

Internal negotiation is fundamentally different from offer negotiation. When you negotiate a new offer, you have maximum leverage and a clear walk-away. When you negotiate a raise or promotion at your current company, you're working within an existing relationship, a fixed budget cycle, and organizational politics. The tactics change. The preparation matters more.

The Internal Raise Playbook

Asking for a raise is not a spontaneous conversation. It's a campaign that starts months before the actual ask.

Building the Case: The Brag Document

Engineers are notoriously bad at tracking their own accomplishments. You ship a feature, it goes to production, you move on. Six months later, when it's time for performance reviews, you can't remember half of what you did.

Maintain a running brag document:

Brag Document Template:

## Q1 2026

### Projects Shipped
- Led migration of payment service from monolith to
  microservice. Reduced p99 latency from 800ms to 120ms.
  Zero downtime deployment. Handled $2.3M in daily
  transaction volume.

### Impact Metrics
- Payment processing latency: -85% (800ms -> 120ms)
- Incident rate for payment failures: -60% (12/month -> 5/month)
- Developer deployment time: -70% (45min -> 13min)

### Scope & Leadership
- Mentored 2 junior engineers on the payments team
- Wrote and drove adoption of new error handling RFC
- Interviewed 8 candidates (4 hired)

### Recognition
- Shoutout from VP of Engineering in all-hands
- Selected for on-call lead rotation

Update this weekly. Spend 10 minutes every Friday adding what you did. When review time comes, you'll have a detailed, evidence-backed case instead of vague recollections.

Market Data

Your brag document shows what you're worth internally. Market data shows what you're worth externally. You need both.

Gather before your raise conversation:
  - levels.fyi: median TC for your level, location, YOE
  - Recent offers from peers (if they're willing to share)
  - Blind posts about comp at your company and competitors
  - Your company's published salary bands (if available)
  - H1B salary data for your company (public record)

Package it simply:
  "Market median for [level] in [location]: $X TC
   My current TC: $Y
   Gap: $Z (N% below median)"

Impact Evidence

Companies give raises based on demonstrated impact, not effort. Frame everything in business terms:

Weak framing:
  "I worked really hard on the migration project."
  "I've been here for 3 years and I think I deserve more."
  "I took on extra responsibility when John left."

Strong framing:
  "The migration I led reduced payment latency by 85%,
   which directly improved conversion rates by 2.1%.
   On our volume, that's approximately $1.2M in annual
   revenue impact."

  "I've consistently operated at the [next level] scope
   for the past two quarters, as evidenced by [specific
   examples]. I'd like to discuss formalizing that with
   a promotion and compensation adjustment."

  "After John's departure, I absorbed ownership of the
   auth service (50k DAU), maintained 99.99% uptime,
   and shipped two security improvements. I'm effectively
   doing two roles."

Quantify everything. Revenue impact, cost savings, efficiency gains, incidents prevented, users affected. Numbers are harder to dismiss than adjectives.

Timing: Performance Review Cycle

The biggest timing mistake engineers make is asking for a raise on a random Tuesday. Most companies have a structured compensation review cycle, and decisions are made weeks before the results are communicated.

Typical comp review timeline:

October:        Managers asked to submit calibration ratings
November:       Calibration meetings (managers + directors)
December:       Compensation committee finalizes budgets
January:        Managers communicate results
February:       New compensation takes effect

If you ask for a raise in January, the decision was already
made in November. You're too late.

When to act:
  September-October: Have the raise conversation with your
                     manager. Give them time and ammunition
                     to advocate for you in calibration.

  The ideal timing: 4-6 weeks before calibration meetings.

Ask your manager when compensation decisions are made. Then work backward from that date. Your goal is to have the conversation — with your brag document, market data, and impact evidence — early enough that your manager can fight for you in the rooms where decisions happen.

The Mid-Year Check-In

Don't wait for the annual review. Have a mid-year conversation that sets expectations:

Mid-year conversation (June-July):

"I want to make sure we're aligned on what it would take
for me to [get a raise / get promoted] in this cycle.
Here's what I've delivered so far this year [summary].
What else would you need to see from me in the second
half to make a strong case?"

This does two things:
  1. Gets explicit criteria you can execute against
  2. Creates accountability — if you deliver, the raise
     is hard to deny

The Promotion Case

Promotions are different from raises. A raise adjusts your pay within your current level. A promotion moves you to the next level with a corresponding comp increase.

Raise: "Pay me fairly for the level I'm at"
       Usually 5-15% increase
       Requires: market data, performance evidence

Promotion: "I'm operating at the next level"
           Usually 15-30% increase
           Requires: sustained next-level performance,
                     business need, manager sponsorship,
                     peer endorsement

How Promotions Actually Work

At most companies, promotions require:

1. Manager nomination
   Your manager has to put you forward. If they don't,
   you're not getting promoted. Period.

2. Calibration
   Your manager presents your case to a group of managers
   and directors. They compare you to others at your level
   and at the next level. They debate.

3. Evidence packet
   Typically includes: project impact, scope of work,
   technical leadership, mentorship, cross-team influence.
   Your brag document feeds directly into this.

4. Peer feedback
   Some companies require peer endorsements. Choose your
   reviewers strategically — people who've seen your
   best work.

5. Committee approval
   At larger companies, a promotions committee reviews
   all nominations. They're looking for consistency and
   calibration across the organization.

The critical insight: your manager is your advocate, not the decision-maker. You need to make their job as easy as possible by providing clear evidence, market data, and a compelling narrative.

Operating at the Next Level Before the Promotion

Companies promote people who are already performing at the next level, not people who promise they will. This means:

If you want to be promoted from Senior to Staff:

Stop doing only Senior-level work:
  - Individual feature delivery
  - Code reviews within your team
  - On-call for your service

Start doing Staff-level work:
  - Cross-team technical leadership
  - Architecture decisions that affect multiple teams
  - Mentoring other seniors
  - Writing RFCs that influence org-wide practices
  - Identifying and solving problems nobody asked you to solve

Do this for 2-3 quarters BEFORE the promotion cycle.
The promotion should formalize what's already happening.

What to Do When They Say No

Hearing "no" to a raise or promotion request is not the end. How you respond determines what happens next.

When they say no, ask:

"I understand. Can you help me understand what specifically
I'd need to demonstrate to earn this in the next cycle?
I want to make sure I'm focusing on the right things."

Then:
  1. Get specific, measurable criteria in writing
  2. Execute against those criteria for the next 6 months
  3. Check in monthly on progress
  4. Come back next cycle with evidence you met the bar

If they can't give you specific criteria:
  That's a red flag. It means the decision wasn't based
  on your performance — it was budget, politics, or
  something else you can't control.

If you met the criteria and still get denied:
  It's time to look externally. The system isn't working
  for you at this company.

The Counter-Offer Trap

You get an external offer. You tell your current company. They suddenly find budget for a 20% raise. Should you take it?

The counter-offer trap:

Statistics: 50-80% of people who accept counter-offers
leave within 12 months anyway.

Why counter-offers fail:

1. Trust is broken
   Your manager now knows you were looking. You're on
   the "flight risk" list. You'll be first considered
   in any layoff.

2. The underlying problems remain
   You didn't look for a new job because of money alone.
   The culture, the management, the work — those don't
   change with a raise.

3. It was always available
   If they can give you 20% now, they could have given
   it to you before. They chose not to until you forced
   their hand. What does that tell you about how they
   value you?

4. You've used your leverage
   You can't pull this move again for years. Next time
   you're underpaid, you have no card to play.

When counter-offers make sense:
  - You genuinely love the company and team
  - The only issue was compensation
  - The counter-offer brings you to market rate, not
    just a token increase
  - You believe the relationship can survive the process

The general advice: if you've accepted an external offer, take it. Don't let your current company buy your loyalty back with money they should have been paying you all along.

Common Pitfalls

  • Not keeping a brag document. Without specific evidence, your raise request is just an opinion. Track your work weekly and you'll always have ammunition.
  • Bad timing. Asking for a raise after the compensation budget is set is like submitting a PR after the release branch is cut. Know your company's cycle and work within it.
  • Making it about fairness. "It's not fair that I make less than X" is a losing argument. Make it about market data and your demonstrated impact.
  • Threatening to leave without meaning it. If you say "I'll leave if I don't get this raise" and then don't leave, you've destroyed your credibility. Never bluff.
  • Accepting the counter-offer reflexively. The research is clear: most counter-offer acceptances end badly. Make a deliberate decision, not an emotional one.
  • Waiting for the promotion to come to you. Promotions go to people who proactively manage the process: building the case, signaling intent, and operating at the next level before the title catches up.
  • Ignoring organizational politics. Your manager's influence, your skip-level relationship, your visibility to leadership — these all affect promotion decisions. Doing great work in isolation is necessary but not sufficient.

Key Takeaways

  • Maintain a brag document updated weekly. It's your evidence base for every raise and promotion conversation.
  • Time your ask 4-6 weeks before the compensation review cycle, not during or after it.
  • Combine three types of evidence: market data (what the market pays), impact data (what you've delivered), and scope data (what level you're operating at).
  • When denied, get specific criteria for next cycle. If you meet the criteria and are still denied, the message is clear: look externally.
  • Counter-offers have a poor track record. If you've decided to leave, leave. Don't let a last-minute raise change a decision you made for multiple reasons.
  • Promotions require proactive management: operate at the next level first, build the evidence, align with your manager, and ensure visibility with decision-makers.