July 21, 2026 Jo Builds 6 min read

How to disagree with your manager in writing

Hand-colored engraving of a Vanessa butterfly, Drury 1837

The message that says "I think this is a mistake" to the person who decides your raise is its own category of writing. I know the draft-box vigil from my own two-line replies; add a power gradient and every minute of it gets worse. The vigil feels like editing, but mostly it is negotiating with fear, one synonym at a time.

Most advice about pushing back on your boss assumes a conference room. Read their face, soften in real time, retreat if the eyebrows go up. None of that transfers to a doc comment or a Slack DM. In writing there is no face to read and no walking anything back mid-sentence. What you send is what they get, at a time you do not choose, in a mood you cannot see.

That is the case against doing it in writing, and it is real. A written disagreement is permanent. It can be forwarded to people you have never met, quoted back to you months later, pasted into a thread as evidence. And text strips out the reasonable, collegial tone of voice you heard in your head while typing. If your manager opens your message thirty seconds after a rough call with their own boss, your carefully balanced paragraph can read as insubordination. You will never know that happened. You will just notice the reply is cold.

And still I think writing is the better arena for disagreement, not the worse one, if you actually use what it gives you. In a meeting your first draft is your only draft. In writing you control the framing, the order of the argument, and every word that survives to the send button. Nobody interrupts your second sentence. Your worst impulse can be deleted before a single person sees it. That is an enormous edge, and most people throw it away by sending something close to their first version.

A shape that survives being forwarded

Over a lot of these messages I have settled on a shape. Five moves, usually under 150 words total. It is not clever, and that is the point: the writing should be so plain that the only thing left to react to is the substance.

Open with the shared goal, in one sentence. Not flattery, the actual goal: "We both want this launch to hold up in front of customers." This does two jobs at once. It reminds your manager you are on the same side, and it quietly defines the field on which the disagreement will be judged. If the goal is launch quality, then the debate is now about launch quality, not about who is being difficult.

Then state the disagreement plainly. One sentence, no cushioning. "I think shipping on the 15th is a mistake." Write it that bare and leave it that bare. This is the sentence people sand down until it disappears, and I will get to why that sanding is fatal in a minute.

Give your strongest reason. One. Not your three reasons ranked by confidence, not a case file. A single argument your manager must engage with is far harder to dismiss than five they can answer by picking off the weakest. If your best reason cannot carry the disagreement on its own, the other reasons were never going to rescue it. They were decoration, and decoration invites nitpicking.

Then do the thing almost nobody does: name the cost of your own position. "Holding two weeks means we miss the conference window, and that is a real loss." This one move changes how the entire message reads. You stop being someone defending territory and become someone who has weighed a tradeoff. Credibility in written disagreement comes almost entirely from admitting what your position costs, because it is the one move a purely political actor never makes. A manager who has been lobbied before, which is every manager, can smell a one-sided case instantly.

End with a decision request, not a vent. "Can we decide by Thursday whether the date holds?" A message that ends with a concrete question about process hands your manager a door. A message that ends with your feelings hands them a wall, and people who receive walls tend to build their own.

The delete pass

The draft is not done when you finish writing it. It is done after you take things out. Four things go first.

Then the timing rule, which matters more than any of the wording rules: anything written angry waits eight hours. The anger is often the most accurate part of the draft, the part that correctly identified that something is being decided badly. But anger writes for an audience of yourself. It optimizes for the feeling of having said it, not for the outcome of it being read. Eight hours later you can keep the point and lose the temperature, and you will be surprised how often the point gets sharper once the heat is off it.

This is, honestly, the workflow Unvent is named for: vent first, send the good version. I build a tool that swaps a heated draft for a composed one in place, but the practice predates the product and needs no software at all. Write the furious version. Let it do its job, which is showing you what you really think. Then write the version addressed to a reader who has power over you and no obligation to read charitably.

When to stop typing

Written disagreement has a natural expiry, and it arrives faster than most people admit. My rule is two rounds. You state your position, they state theirs, you each go once more. If after that neither position has moved, more paragraphs will not move it. Past that point the exchange stops being communication and becomes documentation, and both of you can feel the shift even if neither says so. Everything written after round two is written for the record.

So ask for fifteen minutes of voice. A call restores the bandwidth text removed: tone, pace, and instant repair. Some of the stubbornness in a written standoff is not conviction at all, just two people defending sentences they have already committed to in print. Voice lets everyone abandon their sentences without ceremony.

One more thing, and I will not soften it: hedged pushback is worse than no pushback. "Just wondering if maybe we should possibly consider revisiting the date?" feels brave to write. Your heart rate says you disagreed. But your manager reads it as agreement wearing a nervous expression, files it as a sign-off, and moves on. Hedging takes the full social cost of dissent, the racing pulse and the reread, and buys nothing with it. Six weeks later, when the launch goes sideways, the record shows you wondered aloud once and then went along. If you are going to spend the fear anyway, spend it on the plain sentence. The fear costs the same either way.

I still rewrite these messages more times than I would like to admit. Building a tone tool did not cure me of it; a hard email can still eat an hour if I let it. The difference is that the rewrites now have a direction instead of being laps. In the next disagreement you send upward, strip the softening from exactly one sentence, the one that states the disagreement itself. Keep everything around it as warm as you like. One bare sentence, surrounded by good faith, is usually all the courage the message needs.

Vent first. Send the version that works.

Unvent lets you type the heated draft, then swaps it, in place, for the one that keeps your point and drops the heat.

Get Unvent, free on Chrome
u

Jo Builds makes Unvent, a Chrome extension that rewrites whatever you are typing, in place, in the tone you pick. More on the about page.