Marketing

How to write a messaging guide your team can actually use

Most messaging guides collect dust because they're full of principles instead of sentences. Here's what to put in one that actually gets opened.

Most messaging guides live in a shared folder somewhere. Opened twice: once when they’re finished and once when someone new joins the team and asks what the product actually does.

That’s a wasted opportunity for an asset that can do a lof of heavy lifting.

The difference between a guide that gets used and one that doesn’t is what it contains. Useful messaging guides give your team sentences. Not principles. Not pillars. Actual sentences they can drop into an email, a call, a social post, or a pitch deck without having to translate anything.

The problem statement

Before you describe what you do, describe what’s broken for the person you’re helping. Two or three sentences, in their words, not yours.

A good problem statement passes one test: if you sent it to your five best customers and asked “does this describe your situation?”, at least four would say yes immediately. The problem statement matters because it’s what you lead with in outreach, in content, and on your homepage. People don’t buy products. They hire solutions to problems they’re already experiencing. Name the problem before you describe the solution and you earn the reader’s attention first.

The value trifecta

Now describe what you do and what changes for the customer.

“We build proprietary algorithms that process behavioural signals” is a features sentence. “By the time a trial user hits their third session, you know whether they’ll convert” is an outcome sentence. The second one is useful. The first one only matters to people already sold on the category.

One outcome sentence isn’t enough though. A complete picture of what you deliver covers three dimensions:

Most messaging guides nail one dimension and skip the other two. A guide that only lists functional outcomes reads like a features list. A guide that only speaks to emotion reads like a therapist’s website. You need all three, because different buyers care about different dimensions.

The value propositions

Below the trifecta sit three or four specific value propositions. Each one has a headline, two or three sentences of supporting body, and one piece of proof (a metric, a customer quote, a before/after).

The part most founders get wrong: different buyers buy for different reasons, and a single value prop can’t cover all of them. A useful mental model, borrowed from Geoffrey Moore’s crossing-the-chasm work, is that innovators buy features, early adopters buy capabilities, and the early majority buy outcomes. Your set of value props has to cover all three groups, or you’re only pitching to a slice of your addressable market.

A second filter worth running over each value prop: which dimension of value does it actually promise?

Any one value prop will emphasise one or two of these. A complete set covers all four. When a deal stalls, it’s usually because the value props addressed dream outcome but the buyer’s real hesitation was effort or time, and nothing in the guide spoke to that.

The positioning statement and the onlyness statement

This is where April Dunford’s positioning work becomes practically useful. Two specific sentences belong in the guide, and they do different jobs.

The positioning statement fills in this template: “For [target audience], who [problem or need], we are a [category], that [key differentiators and value props]. Unlike [primary alternative], we [key differentiator].” It’s the internal compass. Not usually written word-for-word into copy, but every piece of public copy should be traceable back to it.

The onlyness statement is tighter: “We are the only [category] that [unique capability], compared to [alternatives], because [proof or reason].” If you can’t finish it without stretching, you don’t have defensible positioning yet. The statement is also what you test new messaging against. Every proposed headline, tagline, or hook should survive the “does this still fit the onlyness?” question.

The key word in both is “realistic.” Don’t compare yourself to the market leader you’ll beat someday. Compare yourself to what your actual buyer would actually use instead, which is often a spreadsheet, a manual process, or a cheaper tool that doesn’t quite fit.

If either statement sounds like it could apply to three of your competitors, you’re not done.

Motivators

Before you write a single objection response, write down what actually pushes your buyer to act now instead of six months from now. These are your motivators.

They fall into a few categories:

Most founders underweight this section. They write a guide that’s excellent at explaining what they do and why it’s better, with no language for why the buyer should act today. That’s how deals stall mid-funnel. Name the motivators and your outreach, your content, and your sales calls gain a handle on urgency they didn’t have before.

The objection library

This is the section that gets used most in practice. Write down every objection you’ve heard more than once on a sales call, and a one or two sentence response to each.

The mistake most founders make here: they only write responses to “use” objections (“will this work for my specific situation?”). There are actually three types of objection, and your library should cover all of them.

Not a full counterargument. The response that moves the conversation forward without sounding defensive:

“We’re not sure we have the budget” — “Most teams we work with found it by redirecting what they were already spending on X. Happy to walk through how that usually looks.”

“We need sign-off from Y” — “Makes sense. What would Y need to see? I can put something together specifically for that conversation.”

These responses don’t close deals on their own. They keep deals alive long enough to close. A complete library has three to five responses for each of the three objection types, not ten responses for one type.

Keeping it current

A messaging guide goes stale the moment your market, your ICP, or your product changes significantly. Build in a six-month review. Ask your salespeople which parts of the guide they never use — those sections are either wrong or irrelevant.

And when something starts working — a line in a cold email that gets unusual response rates, a phrase that makes prospects lean forward on calls — add it immediately. The best messaging guides are living documents built from what’s actually working, not from what someone thought should work at launch.

The First Round Review’s guide on building a sales narrative has a useful framework for thinking about how messaging evolves at each funding stage.

How I actually build these

A guide with this many components sounds like a Notion doc from hell. In practice it’s manageable because the pieces feed each other: the ICP and problem statement feed the value trifecta, the trifecta feeds the value propositions, the positioning statement sets the frame, the motivators inform the objections, and the boilerplate is a distillation of everything above.

I run this through the GTM dashboard I built for exactly this work. ICP on one tab, market and alternatives on the next, then messaging generates the positioning statement, onlyness statement, value trifecta, value props (tagged by adoption group and value dimension), objections (tagged by anxiety type), motivators, and the three-tier boilerplate. AI drafts each component from the ICP and market input. I edit, pressure-test, and iterate. The structure forces completeness. You can’t skip the emotional dimension of the trifecta because the form expects it. You can’t ship with only “use” objection responses because the library is typed.

The tool isn’t the point. The discipline is. Whether you build it as a dashboard, a Notion template, or a Google Doc, the messaging guide that actually gets used has every component above, filled in with sentences rather than principles, and reviewed often enough to stay true.

The guide only works if the upstream pieces are in place. If your ICP is fuzzy or your positioning hasn’t been audited, the sentences you write will drift from the buyer they’re supposed to move. Start with defining the ICP, then audit the positioning, then build the guide.

KV

Kjell Vandevyvere

Fractional marketing for B2B tech companies

All articles

Recognise what's described here?

If this is the shape of the problem you're sitting with, I'm happy to talk it through.