Skip to content

Setting Up Your Organization

This page walks you through creating your Mention account, creating your organization, and finishing the guided setup so your team has something to learn.

Create your account and organization

  1. Open mentionai.app and complete sign-up.
  2. When prompted, create an organization — usually your company or team name.
  3. You become that organization’s admin: you can connect content, create audiences, invite people, and view progress.

If setup is not finished yet, Mention sends you to the onboarding wizard each time you sign in until you complete it. If you leave and come back, Mention picks up where you left off — you don't lose progress.

The onboarding wizard

The wizard runs in five steps.

Step 1: Choose your industry

Tell Mention what industry your organization operates in — search the list and pick the closest match. Mention tailors what it writes to that industry — the terms it extracts, the articles it writes, and the lessons, exercises, and grading built on them. If none of them fit, choose My industry isn't listed and Mention uses its standard approach. Your answer is recorded either way, and the following steps use it to suggest where to start. Your industry can't be changed once your first audience is created, because all generated content builds on it.

Step 2: Connect a source

Link your first place where content lives — Notion, Confluence, Google Drive, Dropbox, Box, GitHub, Slack, Intercom, or Microsoft Teams. The sources organizations in your industry most often start with are listed first and marked Recommended; every source stays available, so connect whichever you actually use. Mention then pulls a catalog of available content from the source (a few seconds to a few minutes). Connecting Slack adds a step where you pick which channels to export. See Connecting sources.

Step 3: Choose assets

Pick the documents (or other supported content) you want Mention to use — up to 2,000 per integration. Only what you activate here is analyzed, and only what is analyzed can be written from; the wizard waits for that analysis to finish before audience creation. See Managing assets.

If you connected GitHub, this step also offers Analyze code instead: rather than reading documents, Mention reads a repository's code into feature briefs you choose from. It takes longer and uses more credits, but is a good option when your documentation is thin.

Step 4: Create an audience

An audience is a group of people who share one set of Contents (for example, "Engineering" or "Customer success"). Enter a name and the questions this audience needs answered — the question fields start with the four durable questions Mention asks about every part of a product, and you can edit them, add to them, or pick one of the suggested starting points for your industry to fill both instead. Mention searches your sources with those questions to build the audience's Contents, so ask them the way your team asks them. You can also invite teammates here by email — there is no role to choose: they join your organization as members and this audience as learners. You can promote people later — see Inviting members.

Step 5: Give the audience its Contents

These are the lessons you want this audience to learn. Don't worry if you haven't connected the right source material for them yet: Mention will only surface these to learners in the audience once they have meaningful content. Your goal is to describe everything they need to know to be successful.

For each topic, add an entry: a name members see, and a prompt describing what the article should cover. Mention writes each entry into an article from the sources you activated, asynchronously — so entries appear with a status and their documents land shortly after — and then composes each article's lesson, the exercises your members work through. Finish onboarding when you're done; future sign-ins go straight to the app instead of the wizard. See Curating contents and Curating lessons.

After onboarding

You land on Chat in your first Audience. Conflicts — the contradictions only you can settle, the ones Mention could not resolve from your own material (see Conflicts) — is in the sidebar, and everything there resolves in place. Open an Audience and you land on Chat — its most-asked answered questions listed beside the conversation — with Lessons (everything written for it, grouped by topic and filterable), Gaps (the open questions owed to it), and People (who is on it and how they are doing) in the sidebar beside it. Learners land on Chat, with Lessons, Review, and the Exam once it opens — because owning an Audience is not learning from it. The Lessons entries carry the authoring controls for owners, who also keep a compact ask field on each entry's page.

The admin sidebar shows one Audience at a time — switch with the audience switcher at the top — with Chat and Gaps for that Audience, then Conflicts and the org-wide Sources every Audience draws on unless an access rule narrows one, and the Audience's Topics below them. Mention puts each term it has learned on the word wherever it is used, so the vocabulary reaches you in place rather than as a list to browse (see The Glossary); contradictions between your sources are resolved from Conflicts (see Reviewing Contradictions).

Your plan and credits are not in the sidebar. Open the organization switcher in the sidebar footer and go to the Usage page to see them; billing and pricing are reachable from there (and from the banner Mention shows when credits run out).