Skip to content

Document audiences - #7381

Open
chitalian wants to merge 3 commits into
mainfrom
audiences
Open

chitalian wants to merge 3 commits into
mainfrom
audiences

Conversation

@chitalian

@chitalian chitalian commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the audience property. Implementation is in mintlify/mint#11279 and mintlify/server#8224. Merge this with them.

  • New page create/audiences.mdx. How to tag navigation groups and pages, the reserved default audience, how readers get an audience from the groups in their user data, how audience works alongside groups and public, where it applies, and a worked example with a who-sees-what table.
  • One-line cross-links from the groups section of authentication setup, the page visibility section of personalization, and the groups section of navigation.
  • Registered under Create, after Personalized content.

The model

An audience is a group name. A reader whose user data includes internal is in the internal audience. Pages tagged with an audience are shown only to readers in it, across navigation, search, the assistant, and MCP. Untagged pages are shown to everyone. default is reserved for readers who match no audience, which includes every signed-out visitor. Audience decides what a reader sees. Groups still decide what a reader can open.

Sample sites: products-based workaround and audiences sample.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes with no product code or configuration behavior in this repo.

Overview
Adds Audiences documentation so readers can learn how to tag pages and nav groups with audience, use the reserved default audience, and combine audience with groups and public.

The new create/audiences.mdx page covers tagging in docs.json and frontmatter, how signed-in readers inherit audiences from user groups, the Viewing as control, which surfaces filter by audience (nav, search, assistant, MCP, llms.txt/sitemap), and a worked example with a who-sees-what table. It notes closed beta and Enterprise/auth requirements.

Cross-links were added from authentication setup (groups vs visibility), personalization (page visibility warning), and navigation (optional audience on groups). docs.json registers the page under Create after personalization.

Reviewed by Cursor Bugbot for commit 787e552. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds a page for tagging pages and navigation groups with an audience so each
kind of reader is shown the content written for them, with the reserved
default audience, how readers land in an audience from their groups, how the
property combines with groups and public, and a worked example. Cross-links
from the authentication, personalization, and navigation pages.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 17, 2026, 4:04 PM

Shorter sections, one idea per sentence, and plainer cross-links.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant