Yalla Marketing

What is a messaging doc?

In short

  • A messaging doc is one document that holds your messaging: the value proposition, the boilerplate, the elevator pitch and the objection handling.
  • It sits between the positioning decisions and everything you write, so every page, pitch and AI prompt starts from the same words.
  • It starts with the decisions it's built on: the category, the audience, the outcome they want and the strategy.
  • It only works if people open it, so keep it short and put it where the work happens.

Most startups have their messaging spread across a pitch deck, a homepage, a few sales emails and the founders' heads. Each piece is fine on its own. Put them side by side and they describe slightly different companies.

A messaging doc puts them in one place.

What a messaging doc is

A messaging doc is the single document that holds your messaging. It's the bridge between the positioning, the decisions, and the copy, the words people actually read. Anyone who writes about the company, a founder, a salesperson, a freelancer or an AI tool, starts from it.

What goes in it

When I ran Yalla Marketing through my own Positioning Builder, the messaging doc it produced started with the decisions, so nobody has to guess what the words are built on:

  • The product category.
  • The target audience: the type of company and the persona.
  • The outcome they want.
  • The positioning strategy, with the paths not chosen and why.
  • The current alternative and what's wrong with it.
  • The use cases, the three USPs under the value proposition and the KPIs that show them working.

Then come the words built on those decisions:

The "paths not chosen" line matters more than it looks. It records what the founders decided against, so the debate doesn't reopen every time someone new joins.

Why the decisions come first

A messaging doc that starts with the tagline invites people to argue about words. One that starts with the decisions lets them check the words against something. If a new homepage line doesn't fit the audience or the strategy written at the top, you change the line and keep the strategy.

Keep it usable

A messaging doc only works if people open it. A few things help:

  • Short over complete. One page per section, written to be copied from.
  • Words people can paste. The pitch and the boilerplate as finished text, not as notes about what they should say.
  • Where the work happens. Next to the website copy and in your marketing brain, so AI tools read it too, instead of in a folder of old decks.

It also helps to agree on which parts everyone repeats the same way. That part is small: the value proposition and the three USPs. A salesperson can open a call with a different story, and a post can come at the problem from a new side, as long as both land on the same value proposition and the same three reasons to choose you. Those four are what you check every new page and pitch against.

Yours, after session 3

Between sessions 2 and 3, my Positioning Builder writes the first draft from the decisions we made, plus your homepage, product page and FAQ. In session 3 we review it with you section by section, you send your last edits through the Builder's feedback tool, and it goes into your marketing brain as one of its files.

How does your own homepage score? Get a free homepage audit: your homepage scored on the same 7 dimensions of positioning, with a line from your own page behind each score. Free, private, never published.

Questions

Frequently asked questions

What is a messaging doc?

It's one document that holds your messaging: the value proposition, the boilerplate, the elevator pitch and the objection handling. Anyone who writes about the company starts from it.

What should a messaging doc include?

First the decisions it's built on: the category, the audience, the outcome they want, the strategy with the paths not chosen, the alternative, the USPs. Then the words: value proposition, tagline, elevator pitch, boilerplate, tone of voice and objection handling.

Does the messaging doc include the positioning decisions?

In ours they live in one file: the decisions at the top, then the words built on them, written to be copied into pages, pitches and prompts.

How do I make sure people use the messaging doc?

Keep it short, write the pitch and the boilerplate as finished text people can paste, and keep it where the work happens, including your marketing brain, so AI tools read it too. Agree that the value proposition and the three USPs are said the same way everywhere, and check every new page and pitch against them.

Yalla, let's talk

AI gave you superpowers. Your marketing still needs a brain

Yalla, let's talk