Audiences¶
Audiences are how Mention scopes learning content to specific groups. Each Audience represents a team, role, or cohort that shares a common body of knowledge.
What is an Audience?¶
An Audience is a named group of members who share a specific set of learning content. When you create an Audience, Mention automatically provisions two things for it:
- A Glossary — the collection of concepts (key terms) the group needs to learn
- A Playbook — the collection of processes (workflows) the group needs to understand
Every piece of learning content in Mention is delivered through an Audience. Members only see the Glossary and Playbook for the Audiences they belong to.
Why Audiences matter¶
Not every team member needs to know everything. A new hire on the engineering team needs different knowledge than someone in customer support. Audiences let you:
- Scope content to roles — Each Audience gets its own Glossary and Playbook, so you control exactly what each group learns.
- Personalize learning paths — Concept ordering and dependencies within a Glossary define the recommended sequence for each Audience.
- Track progress per group — See how adoption is progressing for each Audience independently.
Creating an Audience¶
Admins create Audiences from the Audiences section or during the onboarding wizard. To create an Audience, you provide:
- Name — A descriptive name like "Engineering Team," "New Hires," or "Customer Support"
- Description — A brief explanation of who this Audience is for and what they will learn
Right after you create an Audience, Mention runs a short conversation: you describe what the audience does, and Mention builds the first version of its Glossary and Playbook from your answers and the sources you've activated. You can reopen that conversation later (the Refine button on the audience) to adjust it. From there you refine which concepts are in the Glossary, which processes are in the Playbook, and which members belong to the Audience.
Members and Audiences¶
Members are assigned to Audiences by an admin. A member can belong to multiple Audiences and switch between them in the learning interface using the audience selector in the header.
Each Audience provides a completely separate learning experience — different concepts, different processes, independent progress tracking.
How members are assigned¶
- While creating an Audience — Admins can invite users by email at that step of audience creation (in onboarding or after)
- Adding existing members — Admins add existing organization members to an Audience from its Members tab
- Via invitation — Admins send email invitations from the audience; new users are assigned to the Audience when they accept
Agent access¶
In addition to human members, Audiences can grant access to Agents — API identities that let external tools and automations query an Audience's Glossary and Playbook programmatically. An Agent can be granted access to multiple Audiences, and each grant is managed from the Agent's detail view.
An Audience cannot be deleted while it still has active Agent grants — or members, or pending invitations. Remove those first (and remove the grants, or delete the Agent).
For more on creating and managing Agents, see Agents.
Frequently Asked Questions¶
As members learn and ask questions through the Q&A footer, Mention tracks those questions. When multiple members ask similar questions about the same Audience's content, Mention aggregates them into FAQs on the Audience's FAQs tab. This helps admins identify knowledge gaps and areas where content may need improvement.
The FAQ list is rebuilt periodically — roughly every ten new member answers — rather than in real time, so it tends to lag live activity by a small window. See Managing Audiences for how to review and resolve FAQs.