Short answer

Ask 4-6 months before the next promotion cycle, in a regular 1:1, with a single line: "I want to be promoted to [level] at the next cycle — can we walk through where I am against the bar?" Don't pitch. Don't list achievements. Make your manager say the words "you're not there yet" or "let's build the packet." Everything after that is execution against a clear gap.

Here's what's changed about engineering promotions in 2026: the technical bar has moved, and almost no one is being honest about it.

Five years ago, shipping a complex migration was a Staff-level proof point. Building an SDK solo was Staff-level. Refactoring a core service was Staff-level. In 2026, all of those are table stakes. Anyone with Claude, Cursor, or Copilot can ship the code. What the committee is actually weighing now is the decisions you made, the people you influenced, and the written artifacts that survive after the project ships. Engineers who don't understand this shift are walking into promotion conversations with the wrong evidence.

This guide is the conversation, the packet, and the strategy — written for engineers asking for a promotion in 2026, not 2021.

The conversation itself

Most promotion conversations go wrong before they start because engineers treat them like sales pitches. They lead with achievements. They pre-empt objections. They show up with a list of projects and expect their manager to nod along. That's the wrong shape.

Your manager already knows what you've done. What they don't know is whether you understand the gap between your current work and the next level. The conversation is about calibration, not advocacy. Open it with calibration, and you give yourself information to work with. Open it with advocacy, and you've turned your manager into a critic before they've thought about it.

Here's the actual script. Use it in a regular 1:1, not a special meeting. The fact that it's a normal 1:1 is part of the signal.

The conversation — 90 seconds

You: "I want to be promoted to [Senior / Staff / Principal] at the next cycle. Before I put anything together, can we walk through where I am against the bar — specifically, the gaps?"

If they're supportive: "Great. What are the two or three things you'd want to see in the packet that you don't already have evidence of?"

If they hesitate: "Got it. What would I need to demonstrate in the next two performance periods for this to be a real conversation?"

If they push back hard: "I hear you. Is the bar I'm being held to the company's standard, or is it specific to this team's calibration?"

That last question is the one almost no one asks, and it's the most important. Manager bars vary wildly. A Staff bar at a high-scrutiny calibration team can be 20-30% harder than the same bar two teams over. If your manager admits the bar is local, you have a real problem to solve — either change the work, change the team, or change the company. If they insist it's the company bar, they need to point to the rubric. The rubric exists at every company above 100 engineers. Make them open it.

Notice what's missing from the script: a list of your accomplishments, a deadline, an ultimatum, a comparison to a peer, a mention of an outside offer. None of those help in the opening conversation. Some of them help later. None of them help here.

What's actually changed in 2026

The honest version of what's happened to engineering promotions over the last 24 months: AI-assisted development has compressed the time-to-ship for almost every solo technical task. A migration that took a Senior Engineer six weeks now takes two. An SDK that took eight weeks now takes three. The output is the same. The story you tell about the output is different.

Committees have responded by weighting the non-technical evidence more heavily. They're not asking "did you ship this?" anymore — everyone is shipping. They're asking "did you make the call about what to ship, and did your written artifacts change how other people think about the problem?" That shift has three concrete consequences for your packet:

The corollary: if your last six months produced zero written artifacts — no RFCs, no design docs, no post-mortems, no architecture decision records — that's the gap to close first. Asking for the promotion before you have them is asking the committee to evaluate work they can't see.

The 2026 bar test: If your three strongest promotion projects could have been completed by a competent Senior using AI tools in a quarter, you're showing Senior work, not Staff work. The level shift is in scope and influence, not raw output volume.

The 3-section promotion packet

Promotion packets in 2026 should be 1.5 to 2 pages, not 8. The committee is reading 15-30 of these in a calibration window. Long packets hurt you. They signal that you don't know what matters. The shape of a good packet is brutally short and obvious.

Section 1: Meta-claim (3 sentences)

State the level you're asking for. State that you're already operating at that level. State the timeline of evidence the packet covers. That's it.

Example — Section 1

Asking for promotion to Staff Engineer. Over the last 12 months I have been operating at Staff scope: technical ownership for the payments authorization domain spanning three teams, primary author of the deprecation RFC adopted in Q1, and incident commander for two Sev-1 events. This packet covers projects shipped between July 2025 and June 2026.

Section 2: Three projects (one paragraph each)

Three. Not five. Not eight. Three. Each one must satisfy four properties:

The structure of each project paragraph: one sentence on the problem, one on the approach you decided on (and what you rejected), one on the artifact you produced, one on the measurable outcome. Four sentences total. If you can't compress a Staff-level project into four sentences, you don't yet understand why it was Staff-level.

Section 3: The one thing you're closing (1 sentence)

Self-awareness counts. Committees discount packets that present a flawless picture, because flawless packets read as either overclaimed or as evidence that the engineer hasn't reached the level yet (people at the next level know their own gaps). Pick one real gap. State what you're doing to close it. Move on.

Example — Section 3

The gap I am actively closing is cross-organizational influence outside the payments domain — I am currently driving the API versioning standard discussion with the Platform team, targeting an adopted RFC by Q3.

The written artifacts the committee actually reads

Of the three or four documents committee members will read in detail when evaluating your packet, almost none are the projects themselves. They are the artifacts you wrote about the work. Some of these are worth 10x more than others. In rough priority order:

Artifact Why it matters
Architecture RFC Highest-signal artifact in 2026. Shows you can identify the right problem, propose a solution, and convince others. If three teams adopted your RFC, that's a Staff-level outcome on its own.
Post-mortem you led Demonstrates judgment under pressure, root-cause discipline, and the ability to write so the entire org learns. A great post-mortem can carry a packet.
Strategy doc Most engineers never write one. If you wrote the 12-month strategy for your domain and leadership adopted it, you're operating at Staff scope by definition.
ADRs (Architecture Decision Records) Lower-stakes individually but cumulative. A pattern of 8-10 ADRs across a year shows consistent judgment in a way no single doc can.
Tech-debt audit / migration plan Shows you can see the system as a whole and make trade-offs. Doubles as a witness magnet — people who reviewed it become packet supporters.
Onboarding / runbook docs Counts as multiplier evidence but committees discount it — it's "manager work" in their framing. Include only if asked.

If you look at this list and realize you have zero of the top three from the last six months, that's the actual problem — not whether to ask for the promotion. Spend a quarter producing one RFC and one post-mortem before you have the conversation.

Witnesses: the part most engineers skip

A promotion packet without witnesses is just a memo. Committees triangulate — they ask senior engineers and managers outside your team whether they've seen you operate at the next level. If the answers are blank stares, the packet stalls regardless of how good it is.

This is why cross-team work matters so much in 2026: it generates witnesses. Every RFC review you lead, every incident you commander, every architecture meeting you present at is a potential reference. The Senior Engineer on the Platform team who watched you negotiate the API contract has more credibility with the promotion committee than your direct manager does.

Practical tactic: before the cycle, identify five engineers (Staff or above, ideally on different teams) who have meaningfully observed your work in the last 6-12 months. Ask if they'd be willing to provide input if your manager reaches out. Don't ask them to advocate — just to be available. This is a normal, professional ask. Most will say yes. Your manager now has a list of witnesses they didn't have to source themselves.

If you can't think of five engineers outside your team who've seen you in action, you have your answer about whether you're ready. The committee will reach the same conclusion. Spend the next 6-12 months getting cross-team scope before asking again.

What to do when your manager doesn't support it

This is the conversation almost no one is prepared for. Your manager hears the ask. They don't engage. They redirect to "let's see how Q3 goes" or "I'd want to see more from you on X first" without specifics. That's a soft no. Don't accept the soft no.

The follow-up: "Can we put concrete criteria on this? What specifically would I need to demonstrate, on what timeline, for this to be a real conversation at the next cycle?" If they can't or won't give specifics, you have important information — either they don't actually support the promotion and are managing your expectations, or the bar at your company isn't well-defined enough to be hit deliberately.

If you've been at-level for 18+ months with no concrete path forward, the honest answer is to look externally. An external move at the target level typically captures 30-60% more comp than an internal promotion would, and you reset into a calibration that takes you seriously. Browse Senior, Staff+, and Principal roles across the JBC directory for companies where the next-level scope you want is built into the role from day one.

Most engineers wait too long to ask, then ask too aggressively when they finally do. The right cadence is one calibration conversation every 6 months, with a real ask at the cycle where the evidence is undeniable.

Timing: when in the cycle to ask

Promotion cycles at most tech companies run twice a year, typically locking in January-February and July-August. The conversation about the next cycle should happen 4-6 months in advance, not at the cycle itself. By the time the cycle starts, the packet is being written, not built.

Here's the real timing question almost no one gets right: when should you ask for the second conversation? The answer is six weeks before the cycle. That's when your manager is finalizing who they're nominating, what evidence they're including, and how they're framing each engineer's case relative to the rest of the team. Showing up six weeks out with a tight summary of your three strongest projects and your three strongest written artifacts makes their job easier — and a manager whose job you've made easier becomes your strongest advocate in the room.

The companies where the bar is clearest

Some companies have well-defined promotion rubrics — written, calibrated, applied consistently. Others have rubrics that exist nominally but are interpreted differently in every org. The clearer the rubric, the more "asking for a promotion" becomes "executing against a known specification."

Based on our research across companies in the JBC directory, the engineering cultures with the most legible promotion paths tend to be the ones where engineering ladder documents are either public or widely shared internally:

If your current company has neither a clear rubric nor a culture that lets you operate at next-level scope before the title arrives, that's a structural ceiling. You'll spend years hitting it. The fastest path is often the lateral move — same level, new company, with a path to the next level built into the role.

The one mistake to avoid

The single most damaging mistake engineers make in promotion conversations is comparing themselves to a peer. "Alex got promoted to Staff last cycle and I'm doing the same work." Don't say this. Ever. To anyone.

Two reasons. First, you almost never have full visibility into the evidence behind someone else's promotion — you see the work they shipped, not the artifacts they wrote, the cross-team alignments they drove, or the strategic decisions they made. Your version of the comparison is incomplete. Second, the moment you frame yourself relative to a peer, you've made the conversation about fairness, not about your own bar. Managers and committees do not respond well to fairness arguments. They respond to evidence.

The right comparison is to the published rubric. The wrong comparison is to your colleague. Stay on the right side of that line and the rest of the conversation gets much easier.

Frequently Asked Questions

When should I ask for a promotion as a software engineer?+
Ask 4-6 months before the next promotion cycle, not at the cycle itself. The committee needs evidence you've been operating at the next level for at least two performance periods. The actual conversation with your manager should happen at your next 1:1 after you can point to three shipped, measurable projects at the target scope, plus at least three written artifacts (RFCs, design docs, post-mortems) from the last six months. Skip this conversation if you don't have those artifacts yet — spend the quarter producing them first.
What should I include in a promotion packet?+
Three sections: (1) The meta-claim — 3 sentences stating what level you're asking for and why you're already operating there. (2) Three shipped projects with quantified outcomes — one paragraph each, owned end-to-end, measured in numbers not adjectives. (3) The one gap you're actively closing — 1 sentence showing self-awareness. The whole thing should be 1.5-2 pages. Anything longer and the committee will skim. Promote your strongest written artifact (an RFC, post-mortem, or strategy doc) by linking to it directly — that's often the single piece of evidence the committee reads in full.
How has AI changed the bar for engineering promotions in 2026?+
The technical bar has moved up. Work that used to qualify someone for Staff — shipping migrations, building SDKs solo, refactoring a core service — is now table stakes because AI tools collapse the effort. Committees now weight the non-technical work more heavily: scope, cross-team influence, written artifacts, and the decisions you made. "Wrote the RFC that aligned three teams on the deprecation strategy" beats "shipped a 50K-line migration" in 2026 because anyone with Claude or Copilot can ship code at scale. The differentiator is judgment and influence, not output volume.
What if my manager doesn't support my promotion?+
Promotion without manager sponsorship is functionally impossible at most companies — they write the packet and present it. If your manager isn't supportive, the real conversation is: what specifically am I missing, on what timeline, and is this calibration based on this team's bar or the company's? If the bar is unreasonable or constantly shifting, that's a signal to look for a manager and team where the bar is clear. Sometimes the fastest path to promotion is a different role at a different company — an external move at the target level typically captures 30-60% more comp than an internal promotion would.
How long does it take to get promoted as a software engineer?+
Typical cadence is one promotion every 2-3 years through Senior. After Senior, the timeline slows substantially: Senior to Staff usually takes 3-5 years, and Staff to Principal often takes 4-6+. The biggest variable is scope expansion — engineers who join high-growth teams or new product areas get promoted faster because the work itself forces them into next-level scope. Engineers in stable, well-staffed areas can stagnate for years even with strong individual performance.
Is it better to ask for a promotion or change companies?+
Internal promotion typically increases total comp 15-30%; an external move can be 30-60% but resets your tenure, calibration, and political capital. Ask internally first if you have manager support, written artifacts to point to, and a packet that meets the bar. Go external if you've been at-level for 18+ months with no progress, if your scope is structurally capped on your current team, or if your company's promotion bar is meaningfully harder than peer companies. The honest answer: do both. Run an external interview loop while building your internal packet — offers in hand make every internal conversation easier.

Next-level roles, with culture context

Browse Senior, Staff, and Principal openings across companies with the clearest engineering ladders. Every role tagged with the cultural signals that determine whether the scope you want is actually available.

Browse Staff+ Roles → Explore Companies →