Clarification Questions - Admin Configuration
Enabling the feature
Clarification settings live in the admin app under Settings -> Features -> Clarification Settings. The hierarchy is community → category → board, with each level containing an enable toggle. Boards inherit from their category and community defaults; the per-board toggle overrides them.
Admin settings — community, category, and per-board enable togglesUse the Configure button on any board to open its detailed settings (Section 3.2). The master "Enable Clarification Questions" switch at the top disables the feature globally regardless of any per-board toggles.
Reminder: only Forum and Ideas boards support this feature in Aurora 26.3.
Per-board settings
Per-board configuration panel|
Setting |
Default |
Description |
|---|---|---|
|
Maximum Questions |
3 (1–6) |
Upper bound on AI-generated questions per post. The AI may generate fewer. |
|
Show Info Banner |
On |
Whether to display the info banner in the post editor. |
|
Banner Text |
Default copy |
Editable banner copy. Use {maxQuestions} as a placeholder for the configured maximum. |
|
Reminder Email Delay |
24 hours |
Hours before the reminder email is sent for unanswered clarification questions. |
|
CM Guidance Examples |
Empty |
Optional examples that hint to the AI what to ask. Not shown verbatim to users. |
Writing good guidance examples
Guidance examples are short hints that help the AI understand what kind of detail your community typically needs. They are passed to the model alongside the post and similar-post context from CLM, but are not shown to users verbatim since this is not a form creator.
Works well
- "Always ask which authentication method is being used (SAML, OIDC, OAuth)."
- “Briefly explain your task and what you were trying to achieve.”
- “What are the versions of the platform, and other third-party components, you are working with?”
- “Have there been any recent changes to the configurations? Please include details about relevant component versions (Elastic Search, Spark, Database).”
- "For login or access issues, ask whether the issue is reproducible in incognito."
- "For mobile bugs, ask for OS version and app build number."
- “Are there any error messages encountered? What are the relevant logs and stack traces?”
Works less well
- Long, multi-part questions trying to anticipate every scenario.
- Generic prompts ("Tell us more") - the AI already does this.
- Examples written as instructions to users - the AI generates fresh questions, it does not paste your text.
|
Note: Guidance is optional. Without examples, the AI generates questions based on the post and similar-post context alone. |
Interaction with Answer Assist
The clarification questions serve as additional context for the Answer Assist where applicable.
|
Answer Assist delay |
Behavior |
|---|---|
|
Greater than 0 |
The post publishes and the clarification panel surfaces. Answer Assist waits per its delay, then fires using approved clarification answers as additional context, when available. |
|
Equal to 0 |
Answer Assist fires immediately on the original post. If it produces a strong cited answer, clarification is not shown. If it cannot cite, clarification surfaces and the email reminder is sent. The expert recommendation card may also appear in parallel. |
|
On COMPLETED (clarification was skipped initially, completed later) |
Answer Assist re-runs with enriched context (original post + approved Q&A) to attempt a cited answer. On boards with AI moderation, the re-run is deferred until clarification answers complete moderation. |
Moderation of clarification answers
Clarification answers are moderated independently of the original post:
- Pre-moderation boards — answers start as PENDING; AI moderation runs async and updates each to APPROVED or REJECTED.
- Post-moderation boards — answers start as APPROVED; AI moderation can subsequently reject.
- Moderation off — answers are auto-approved.
- Moderation bypass — users with bypass permissions get answers auto-approved.
- Cascade approval — when a parent post is approved, attached PENDING answers are auto-approved.
|
Note: Rejecting a clarification answer hides only that answer, the original post is unaffected. The user is notified to edit the answer. |
Clarification Review
A new Clarification Review page in the admin app lists every post that entered the clarification workflow, with metrics at the top and per-post actions in the table.
Clarification Review page in the admin appMetrics
- Total Workflows — count of posts that entered the workflow.
- Completion Rate — share that reached COMPLETED.
- Skip Rate — share ending in SKIPPED.
- Avg Questions — average number of questions generated per post.
- Email Prompt Rate — share where the reminder email was sent.
Filters: status, board, date range. Metrics can be sliced by board, locale, and time period.
Per-row actions
- View Post — opens the post in a new tab.
- View Q&A — expands the row to show questions and answers inline.
- Resend Nudge — re-sends the email reminder. Useful for PENDING and ABANDONED posts.
- Reset to Pending — moves a SKIPPED or ABANDONED post back to PENDING so the author sees the "Add Details" banner again.
- Moderate answers — approve or reject individual answers with a reason (SPAM, ABUSE, OTHER), or use Approve All to bulk-approve pending answers in a collection.