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. 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 yours isn't listed yet, choose General 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 table of contents (for example, "Engineering" or "Customer success"). Enter a name and description, or pick one of the suggested starting points for your industry to fill both fields and then edit 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 a table of 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 your Audiences. Open one and you get the owner's tabs: Questions (gaps members hit — the default home), Curriculum (the table of contents you author, and each entry's article and lesson), and People (who is on it and how they are doing). Learners get Ask and Hub instead — Hub when they still have learning to do, Ask when they are current — because owning an Audience is not learning from it. Owners keep a compact Ask field under the Curriculum and People tabs; Questions has its own ask box built in.

The admin sidebar lists your Audiences, then the org-wide Sources section every Audience draws on — which is also where you resolve contradictions (see Reviewing Contradictions). Your organization's vocabulary needs no section of its own: Mention maintains the glossary from your sources and puts each definition on the word where it is used (see The Glossary).

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).