Skip to content

Document product name property and site-wide public setting#4785

Open
mintlify[bot] wants to merge 5 commits intomainfrom
mintlify/doc-products-public-1774055462
Open

Document product name property and site-wide public setting#4785
mintlify[bot] wants to merge 5 commits intomainfrom
mintlify/doc-products-public-1774055462

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Mar 21, 2026

Summary

Documents two previously undocumented configuration options identified from the latest package bump:

  • Product name property: Products now support an optional name field that sets a display name in the product switcher, separate from the product identifier. Also documents the hidden property for products.
  • Site-wide public setting: A top-level public boolean in docs.json that changes the default visibility of all pages when authentication is enabled. When true, pages are publicly accessible unless explicitly overridden.

Changes

  • organize/navigation.mdx: Added a properties table for products and updated the example to show name usage
  • organize/settings-reference.mdx: Added name, hidden to products type description; added public to quick reference table and full property reference
  • deploy/authentication-setup.mdx: Added site-wide default section explaining the top-level public property

Note

Low Risk
Low risk: documentation-only changes that describe existing configuration options; no runtime or schema enforcement code is modified.

Overview
Documents a new site-level public flag in docs.json that flips the default visibility when authentication is enabled, with guidance on overriding via page frontmatter.

Expands product switcher docs to list supported product fields (including name and hidden) and updates examples/type references accordingly, plus minor copy edits around expanded group behavior.

Written by Cursor Bugbot for commit de7a4bb. This will update automatically on new commits. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Mar 21, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Mar 21, 2026, 1:14 AM

ethanpalm and others added 2 commits March 30, 2026 17:18
name only affects the switcher trigger label (selected product), not the
dropdown list items, which always show the product identifier.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Group-level public overrides are not reflected in page access control —
only frontmatter-level public: false gates unauthenticated access.

Co-Authored-By: Claude Sonnet 4.6 <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