Frequently Asked Questions¶
Account and access¶
How do I create a new organization?
Sign in at mentionai.app and use the organization switcher to create a new organization. You become the admin and are guided through the onboarding wizard to set everything up.
How do I switch between organizations?
Use the organization switcher in the sidebar footer (on mobile, it is in the header at the top of the screen). This is available if you belong to more than one organization.
I signed in but there's nothing here. What's wrong?
Two possibilities. You may not be assigned to an Audience yet — if you see a message saying you have not been assigned, contact your admin. Or your Audience's owner may not have added anything to its table of contents yet, in which case the contents list says so.
Content and sources¶
How do I connect a content source?
As an admin, go to the Sources page, choose the provider you want to connect (Notion, Confluence, Google Drive, etc.), and follow the authorization flow. You can also upload your own files. See Connecting Sources for details.
How many documents can I activate per source?
Each integration supports up to 2,000 active documents. See Managing Assets for details.
How often are sources synced?
All integrations sync daily on an automatic schedule. You can also trigger a manual sync at any time from the Sources page.
My integration isn't syncing. What should I do?
Try disconnecting and reconnecting the integration from the Sources page. This refreshes the connection. Make sure the account you used to connect has the necessary permissions in the external platform (e.g., workspace admin in Notion, file access in Google Drive).
What happens when two sources disagree about the same thing?
Mention detects these as contradictions — pairs of facts that conflict, spotted while it is answering a question that draws on both, or when a meeting transcript arrives and a claim in it disagrees with what your documents say. Until one is reviewed, Mention prefers the side stated more recently and hides the older from the AI's context. Conflicts between sources land under Sources → Contradictions, where admins pick which fact is correct and the losing version is retired. When a named member is on one side — a misunderstanding — it is routed instead to the single Audience whose owners can say whether the member got it wrong or the document went stale, and while it waits Mention prefers the document rather than the newer statement. This improves the accuracy of the articles Mention writes and the answers it gives. See Reviewing Contradictions for the detection mechanics and Reviewing Misunderstandings for the routed ones.
Articles and lessons¶
How does an article get written?
An Audience's owner adds an entry to its table of contents: a name members see, and a prompt saying what the article should cover. Mention writes the document from that prompt against your organization's activated source material. Writing is asynchronous — the entry appears with a status, and the document lands shortly after. See Curating Contents.
What is a lesson, and where does it come from?
Once an article is written, Mention composes a lesson from it: 5 to 9 exercises the member works through by attempting things. One article, one lesson, composed automatically — there is nothing extra for an owner to commission. The article is what you consult; the lesson is what makes you know it. See Articles and Lessons.
What do the exercises actually ask me to do?
Warm up with a guess before you're taught anything; decide what to do in a messy scenario; tell near-identical cases apart; find what's wrong with a plausible-looking artifact; reconstruct a procedure from memory; explain why a rule exists; or play out a conversation against a counterpart. Every one of them is a setup, your attempt, and then the correction — nothing is revealed before you commit. The warm-up is never graded and does not count toward finishing. See Working Through Lessons.
How are written answers graded?
Against a rubric — a short list of criteria the answer has to meet. Passing means meeting every required criterion, and the correction names the ones you missed and why. Exercises where you pick an option are checked instantly against an answer key instead.
What happens if I get one wrong?
Nothing bad. There's no score and no penalty. You get the correction, and if you retry you get a variant — the same material in a different situation, not the same question again.
Why can't I read the article yet?
You do — reading is never held back. Every article is available in full, whether or not you have finished its lesson, because a document you might need on the job is no use locked. What changes is only which half an entry opens: while its lesson is outstanding the row opens the lesson, and each exercise offers the passage it was written from under Look it up, with a link to the full article. An entry whose exercises you haven't done also shows a Practice this prompt above the article when you reach it directly. What the lesson tracks is different: reading is not the same as knowing, and only the exercises record that you know it.
Can an owner change a lesson?
Not directly. A lesson is composed from its article, so the way to change what it asks is to change the article — edit the entry's prompt or the sources behind it, and the lesson is composed again from the rewritten document. Owners can walk through a lesson exercise by exercise to see what their learners meet, which records nothing. See Curating Lessons.
What if an article has nothing to exercise?
Some entries are pure reference — a lookup table, a list of definitions — and forcing exercises onto them produces something worse than admitting it. Mention says so: the entry keeps its article and its lesson shows as No lesson possible with the reason. (A lesson only shows as failed when something actually went wrong composing it.)
Can I write or edit an article by hand?
No. You author the prompt, not the document. To change what an article says, change its prompt (which makes Mention write it again), or correct the underlying knowledge by resolving contradictions.
What does "not ready" mean?
It means Mention could not write the article from the sources connected so far, and said so rather than inventing content. The entry shows a one-line reason. This is a normal state, not an error — connect the missing material, or narrow the entry to something your documents actually cover, then ask Mention to write it again. See Curating Contents.
How many articles can an Audience have?
Up to 100.
Can the same article be in two Audiences?
No. An article belongs to one Audience's table of contents. If two Audiences need the same ground covered, write an entry in each: the prompt should say what that Audience needs from the topic, and Mention writes each article for the people who will read it. Two Audiences rarely need the same material framed the same way, which is the point of an Audience.
Progress¶
How is progress calculated?
Lessons you have finished, out of the entries in your Audience's table of contents. You finish a lesson by passing every piece of material it grades. There's no partial credit at the entry level, and entries without an article yet (still being written, or not ready) are not in the denominator.
What does completing an Audience mean, and how is "current" different?
Complete means you have finished every lesson in it. Current means you are complete and nothing in it is overdue for review. Current is the one that means you know the material today — someone who finished in March and hasn't been back is complete but not current. See Monitoring Progress.
Why does material I already passed keep coming back?
That's review, and it's the point. Mastered material returns on a fixed ladder — 1 day, 3 days, 7 days, 21 days, 60 days. Passing moves you up a rung; failing drops you to the first. Because progress is keyed to the material rather than to a particular exercise, an item can come back as a different kind of exercise than the one that first taught it.
If an article is rewritten, do I lose my progress?
No. What you passed is recorded against the material an exercise covers rather than against the exercise, so a rebuilt lesson keeps everything you knew that hasn't changed. Material that genuinely changed comes back to be earned again.
What happened to the reading checkbox?
It's gone. Reading a reference document is not an achievement and Mention stopped recording it as one. Finishing the lesson is what marks an entry done — and it's what unlocks the article for you to read whenever you want.
Can I do lessons on my phone?
Not yet. The lesson player is on the web app and through the MCP server; the mobile app keeps the reading experience only. See Reading on Mobile.
Questions and answers¶
What does "grounded" mean in Grounded Q&A?
It means Mention generates answers using your organization's actual source documents as context, rather than generic information. This makes answers more accurate and relevant to your specific setup.
What happens to a question Mention can't answer?
It's collected as an unanswered question on that Audience's Questions tab, grouped with questions that mean the same thing and counted. An admin closes the gap by answering it, which adds a fact to your knowledge base. That makes future answers possible and can unblock an article that was coming back not ready — but it does not publish anything to an Audience by itself. See Answering Unanswered Questions.
Audiences and members¶
How do I invite team members?
As an admin, open an Audience and click Add members in the header. One dialog handles both: search by name to add people already in your org, or type an email address to invite someone new. See Inviting Members.
Can a member belong to multiple Audiences?
Yes. Members can be assigned to as many Audiences as needed. Every Audience they belong to is listed in the sidebar — clicking one switches to it. Each Audience has its own table of contents, its own articles, and its own progress tracking.
What happens when I remove a member from an Audience?
The member can no longer access that Audience's articles. The Audience's articles are unaffected, and the member's progress records are retained but no longer accessible to them through the app.
Integrations and API¶
Can I access Mention programmatically?
Yes, via the Mention MCP server. External tools — like Claude's connectors or an IDE assistant — connect to it and sign in with your Mention account through a standard OAuth flow; the connection then sees exactly the Audiences you are a member of. See MCP Server Overview.
What controls which Audiences an MCP connection can see?
Your own Audience memberships. The MCP connection acts as you, so it can read every Audience you belong to and nothing else. To change what it can see, an admin changes your memberships in Managing Audiences.
Billing and credits¶
What happens when credits run out?
Actions that consume credits — such as writing articles, composing lessons, and Q&A — become temporarily unavailable. You see a notification suggesting you upgrade your plan or wait for the next billing cycle. Non-credit actions (reading existing articles, viewing progress) continue to work. A written answer submitted while you are out of credits is accepted and marked ungraded rather than lost, so nobody's work disappears — though it comes back without a correction, since nothing was graded.
Do unused credits roll over?
No. Credits reset at the beginning of each billing cycle with no rollover.
What's the difference between plans?
All plans include the same features. Free Trial, Starter, Pro, and Enterprise differ by seat capacity and monthly AI usage allowance. Starter and Pro are self-serve; Enterprise is sold through sales. See Plans and Pricing.
What counts as a credit-consuming action?
Writing an article, grounded Q&A, answering an unanswered question, content analysis (when assets are activated), and contradiction detection all consume credits. See Understanding Credits for the full list.