Skip to content

Creating Audiences

This page explains how you define learning groups in Mention — each with its own Contents — and what to do after you create one.

What an audience is

An audience is a named group of people who share one set of Contents: the entries this readership is told, each of which Mention writes into an article.

Examples: “New hires,” “Support tier 2,” or “Sales — West.” Progress is tracked per audience, so the same person in multiple audiences has separate progress for each.

For the full model, see Audiences.

Create an audience

You can create audiences in two places:

  1. During onboarding — one of the wizard's steps asks for your first audience's name and the questions it needs answered, and offers a few starting points based on the industry you chose. Picking one fills both so you can edit them; writing your own works exactly as before.
  2. After onboarding — open the audience switcher at the top of the sidebar; its New audience action is the way to add another. The dialog asks for a name and one or more questions, and arrives with the standard set already filled in.

Write the questions

The form starts with four questions people ask about most things — Who is it for? Why did we build it? How does it work? How do people use it? — because they are the ones that keep a team aligned. They are a starting point and nothing more: keep them, edit them into your own wording, or replace them entirely. Nothing downstream depends on them, and there is no set of questions an audience is required to ask. See Topics and Questions.

The questions are the whole input. Mention searches your connected sources with each one as written, and the Contents it comes back with are the articles that answer them — so ask them the way your team actually asks them, in your organization's own words. "Who is the new billing flow for?" beats "billing".

Ask for what stays true. Ship dates, prices, and current status belong in Chat, whose answers track when they go stale; articles carry the durable knowledge behind them.

A handful is enough to start; an audience holds at most 20. You do not write a description — Mention writes one from your questions, and that is what appears beside the audience everywhere it is listed.

You can change the questions later over the MCP tools (manage_audience, action update_metadata). Changing them proposes further articles against your sources; nothing you already have is removed or rewritten.

During onboarding, the audience step also lets you invite teammates by email; they join the new audience as learners. After onboarding, creating an audience does not include invites — add people afterwards from the audience's People page, where you can also promote anyone to owner. See Roles.

What you get

Shortly after you create an audience, Mention fills its Contents with a starting set of entries: it searches your connected sources with each of your questions, then groups what it finds into subjects and proposes the articles those subjects support. Where your sources cover ground next to a question you asked, you will see entries for that too. Those articles begin writing immediately. If your sources do not yet cover enough, the contents stay empty — that is the expected answer, not a failure.

Reviewing what it wrote, and filling in what it missed, is the audience owner's job, and it is the next thing to do: add an entry for each topic — a name members see, and a prompt saying what the article should cover — and Mention writes each one from your activated sources, then composes a lesson from it. See Curating contents and Curating lessons.

An audience can hold at most 100 articles.

What to do next

After the audience exists:

  1. Invite members — by email or by adding people already in the org. See Inviting members.
  2. Connect sources and activate assets if you have not already, so there is material to write from. See Connecting sources and Managing assets.
  3. Write its Contents — one entry per thing this audience needs to know. See Curating contents.
  4. Watch adoption as people start working through the lessons. See Monitoring progress.