* Document custom hostname setup for Cloudflare-proxied domains
TXT pre-validation cannot complete while a domain is proxied through
Cloudflare, even when the records resolve correctly. Add a section with
the setup order for proxied domains and link it from the warning.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Update customize/custom-domain.mdx
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* clarify MCP returns MD
* Fix doc issues surfaced by user feedback
- Fix claude mcp add --header argument order: the flag must come after
the positional <name> and <url> args because --header is variadic and
otherwise consumes everything that follows it, causing the "missing
required argument 'name'" error users reported.
- Add tip to wrap iframes in Frame component to prevent overflow (user
suggestion on image-embeds page).
- Fix broken anchor link in quickstart CLI tab: /cli/install has no
#clone-your-repository section; replaced with inline git clone
instructions and a correct link to /deploy/github.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Document wide-mode behavior for side panel
Wide mode hides the entire side panel (not just the TOC), including
Panel components and OpenAPI request/response examples. This was
undocumented and actively confused a user who couldn't understand why
their OpenAPI example panels disappeared on wide-mode pages.
- Fix the wide mode description in organize/pages.mdx (it previously
said only the TOC was hidden, but ContentSideLayout.tsx returns null
for wide/center/custom modes entirely)
- Add a Note to components/panel.mdx calling out that the side panel
is absent on wide, center, and custom pages
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Resolve user feedback: clarify path formats, load timing, and analytics config
- react-components: add Constraints section (hooks pre-injected, no npm, no default exports)
- posthog: fix default host from app.posthog.com to ph.mintlify.com (confirmed via source)
- plausible: add ParamField descriptions including server field explanation
- create/text: note that internal links require root-relative paths without file extensions
- create/image-embeds: clarify image paths are root-relative, relative paths unsupported
- create/redirects: show redirects as top-level field in full docs.json example
- customize/custom-scripts: note that custom JS runs after page is interactive, applies globally
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* 💅
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: fix Vale warnings in files changed in the last week
* docs: mirror Vale fixes to es and fr translations
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestions from code review
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* docs: boost search ranking for single-word title pages
Apply `boost: 3` to English pages whose H1 / frontmatter title is a single word (e.g. "Assistant", "Quickstart", "Cards"). Short titles tend to be canonical landing pages for a topic, so users searching the exact term should land on them first.
* docs: drop boost on websocket-playground stub to keep canonical Playground ranking
`api-playground/websocket-playground.mdx` is an auto-generated AsyncAPI stub with no body content but shares the title "Playground" with `api-playground/overview.mdx`. Boosting both equally diluted the canonical overview page in search for the query "playground". Drop the boost on the stub.
* Add new CSS selector attributes for tabs and topbar components
Generated-By: mintlify-agent
* Clarify CSS selector data attribute docs
- Add note that TabsBarItem uses a class selector (`.nav-tabs-item`) rather than a custom element name, and explain why
- Note that data-active does not apply to dropdown-style TabsBarItems
- Add intro sentence explaining the purpose of data-component-name selectors
- Note that PrimaryHeaderButton is Sequoia theme only
- Fix capitalization of TableOfContentsItem (deepest) description for consistency
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Add Mermaid data-component-name selectors to CSS reference
Documents mermaid-container (outer wrapper) and mermaid-controls-wrapper
(zoom/pan controls overlay) — both use data-component-name in the client
source and are distinct from the existing `mermaid` class selector which
targets only the inner SVG element.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Update custom-scripts.mdx
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Replace internal React names with plain-English labels in data attributes
Labels like DropdownItem, MobileNavTabsBarItem, and MermaidContainer are
internal component names not meaningful to users writing CSS. Replaced with
descriptions of what each element is (e.g. "Active item in a nav dropdown").
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* Revert "Replace S3 URLs with relative paths for theme and hero images (#5051)"
This reverts commit 43b3783e8c.
* fix: use GitHub raw URLs for image assets
Replace S3 bucket URLs with direct links to GitHub raw content for image assets. This provides a more consistent and reliable source for images used across the documentation pages.
* Improve SEO descriptions across 47 pages
Curated descriptions from two bot-generated PRs (#3908, #3949),
selecting the best approach for each page:
- Added missing title and description frontmatter to 10 API reference pages
- Benefit-focused descriptions for integration pages (not implementation-heavy)
- Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.)
- Expanded short descriptions to 50–160 character range throughout
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* copyedit
* Update custom-domain.mdx
* Fix analytics API page titles to match spec summaries
"Export" was inaccurate — spec uses "Get" for both endpoints.
Also updated descriptions to use "Retrieve" for consistency.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: add Luma theme to docs
Updates various documentation sections to officially include the new Luma theme.
Adds Luma to the list of available themes and provides its description in relevant configuration and theme files.
Extends "frame" mode compatibility to include the Luma theme, reflecting its support for this layout.
* chore: losslessly compress images
used https://tinypng.com
* feat: update docs to include sequoia theme
* feat: add sequoia to themes list, replace all themes thumbnails
* feat: replace all themes thumbnails in localized themes pages
Alejandro Cortez