# Mintlify

> Mintlify is a platform for building and hosting documentation websites. It provides a set of tools and services for maintaining documentation and making it accessible to AI agents.

## Docs

- [How to create accessible documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/accessibility.md): Create accessible documentation following WCAG guidelines with semantic HTML, keyboard navigation, alt text, and inclusive content practices.
- [Tutorial: Build an in-app documentation assistant](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/assistant-embed.md): Build and embed an in-app documentation assistant that answers user questions with cited information from your Mintlify documentation site.
- [Work with branches](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/branches.md): Create and manage documentation branches to preview changes, collaborate with teammates, and merge updates before publishing to production.
- [Write documentation with Claude Code](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/claude-code.md): Configure Claude Code with CLAUDE.md project instructions to write, review, and update your Mintlify documentation following your style guide.
- [Write documentation with Codex](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/codex.md): Configure OpenAI Codex CLI with project instructions and MCP to write Mintlify documentation that follows your style guide and MDX standards.
- [Configure automerge for GitHub Apps](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/configure-automerge.md): Set up GitHub workflows to automatically merge Mintlify pull requests by adding the Mintlify bot to your repository's ruleset bypass list.
- [Documentation content templates](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/content-templates.md): Copy and modify ready-to-use MDX templates for how-to guides, tutorials, concept explanations, and API reference pages in your documentation.
- [Documentation content types](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/content-types.md): Choose the right documentation type for each page using the Diátaxis framework: tutorials, how-to guides, reference, and explanation.
- [Write documentation with Cursor](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/cursor.md): Configure Cursor with project rules to write Mintlify documentation that follows your style guide, component usage, and MDX conventions.
- [Headless docs with a custom frontend](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/custom-frontend.md): Build a headless documentation frontend with Astro while using Mintlify for content management, AI-powered search, and assistant features.
- [Build custom page layouts](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/custom-layouts.md): Use page modes and components to build custom landing pages, marketing pages, and other non-standard layouts in your Mintlify documentation.
- [Create developer documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/developer-documentation.md): Build developer documentation that helps engineers integrate with your APIs, SDKs, and tools, including quickstarts, references, and guides.
- [Write documentation with Devin Desktop](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/devin-desktop.md): Configure Devin Desktop's Cascade AI with workspace rules to write Mintlify documentation that follows your style guide and MDX standards.
- [GEO guide: Optimize docs for AI search and answer engines](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/geo.md): Optimize your documentation for AI-powered answer engines like ChatGPT, Perplexity, and Google AI Overviews with Generative Engine Optimization techniques.
- [Git concepts for documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/git-concepts.md): Learn Git version control fundamentals for docs-as-code workflows, including repositories, branches, commits, and pull request collaboration.
- [Create a help center](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/help-center.md): Build a self-service help center on Mintlify that helps customers find answers, reduces support ticket volume, and scales with your team.
- [How to measure and improve documentation quality](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/improving-docs.md): Use analytics, user feedback, and content audits to identify documentation gaps and improve the pages that matter most to your users.
- [Guides](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/index.md): Browse guides on documentation best practices, content strategy, SEO optimization, accessibility, and docs-as-code workflows for your team.
- [How to set up multi-language documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/internationalization.md): Set up multi-language documentation with locale-based routing, language switcher navigation, and translated content to reach global audiences.
- [Create a knowledge base](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/knowledge-base.md): Host your internal knowledge base on Mintlify to consolidate information for your team, improve search, and reduce maintenance burden.
- [How to link documentation pages effectively](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/linking.md): Create internal links, anchor links, and deep links in your documentation, and maintain link integrity with redirects and broken link checks.
- [How to maintain documentation over time](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/maintenance.md): Keep documentation accurate and up-to-date with review schedules, ownership models, automated checks, and content lifecycle practices.
- [How to use images, screenshots, and videos in documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/media.md): Learn when and how to use screenshots, GIFs, and videos in documentation with guidance on format selection, alt text, and long-term maintenance.
- [Migrating MDX API pages to OpenAPI navigation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/migrating-from-mdx.md): Migrate your manually written MDX API pages to automated OpenAPI-generated documentation with flexible navigation and endpoint grouping.
- [How to structure documentation navigation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/navigation.md): Design documentation navigation that helps users find what they need with clear information architecture, logical grouping, and validated structure.
- [How to improve documentation SEO](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/seo.md): Improve your documentation's search engine rankings with page titles, keyword research, internal linking, and technical SEO techniques.
- [How to write technical documentation](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/style-and-tone.md): Write clear, consistent technical documentation with practical guidance on voice, structure, terminology, and tone for developer and product docs.
- [How to understand your documentation audience](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/understand-your-audience.md): Define your documentation audience, research their goals and knowledge level, and apply those insights to write content that helps them succeed.
- [Use automations](https://mintlify-docs-automation-github-pr-review.mintlify.app/guides/use-automations.md): Use Mintlify automations to automate recurring docs maintenance: choose the right trigger, write effective instructions, and get consistent agent results.
- [Introduction](https://mintlify-docs-automation-github-pr-review.mintlify.app/index.md): Mintlify is an AI-native documentation platform built for developers, with beautiful defaults, interactive API playgrounds, and smart search.
- [Adobe Analytics](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/adobe.md): Integrate Adobe Analytics with your Mintlify documentation site using Adobe Experience Platform Launch tags for detailed usage tracking.
- [Amplitude](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/amplitude.md): Integrate Amplitude analytics with your Mintlify documentation site to track user behavior, page views, and content engagement metrics.
- [Clarity](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/clarity.md): Integrate Microsoft Clarity with your Mintlify documentation site to capture session recordings, heatmaps, and user interaction analytics.
- [Clearbit](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/clearbit.md): Integrate Clearbit with your Mintlify documentation to enrich visitor data, identify visiting companies, and track enterprise engagement.
- [Fathom](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/fathom.md): Integrate Fathom Analytics with your Mintlify documentation for privacy-focused, GDPR-compliant visitor tracking with a simple site ID setup.
- [Google Analytics 4](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/google-analytics.md): Integrate Google Analytics 4 with your Mintlify documentation to track visitor behavior, page views, and content engagement with your GA4 ID.
- [Google Tag Manager](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/google-tag-manager.md): Integrate Google Tag Manager with your Mintlify documentation to manage analytics tags, conversion tracking, and marketing events centrally.
- [Heap](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/heap.md): Integrate Heap analytics with your Mintlify documentation site to automatically capture user interactions and events for behavioral analysis.
- [Hightouch](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/hightouch.md): Integrate Hightouch with your Mintlify documentation to sync analytics data for audience activation, segmentation, and downstream tool routing.
- [Hotjar](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/hotjar.md): Integrate Hotjar with your Mintlify documentation site to capture session recordings, heatmaps, and user feedback for experience insights.
- [LogRocket](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/logrocket.md): Integrate LogRocket with your Mintlify documentation to replay user sessions, monitor frontend errors, and debug interaction issues in detail.
- [Mixpanel](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/mixpanel.md): Integrate Mixpanel with your Mintlify documentation site to track product analytics, user behavior funnels, and content engagement events.
- [Analytics integrations](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/overview.md): Connect your Mintlify documentation to analytics platforms like Google Analytics, Mixpanel, PostHog, and more to track visitor engagement.
- [Pirsch](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/pirsch.md): Integrate Pirsch with your Mintlify documentation for GDPR-compliant, cookie-free analytics that tracks page views without collecting personal data.
- [Plausible](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/plausible.md): Integrate Plausible Analytics with your Mintlify documentation for lightweight, privacy-respecting visitor tracking without cookies or consent banners.
- [PostHog](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/posthog.md): Integrate PostHog with your Mintlify documentation site to track product analytics, feature usage, and user behavior with your API key.
- [Segment](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/analytics/segment.md): Integrate Segment with your Mintlify documentation to route analytics events to downstream tools like warehouses, CRMs, and marketing platforms.
- [Osano](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/privacy/osano.md): Integrate Osano with your Mintlify documentation site to manage cookie consent banners, privacy preferences, and regulatory compliance.
- [Privacy integrations](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/privacy/overview.md): Connect your Mintlify documentation site to privacy platforms like Osano to manage cookie consent, compliance banners, and user preferences.
- [Speakeasy](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/sdks/speakeasy.md): Display autogenerated SDK code samples from Speakeasy in your API playground with multi-language examples for Python, TypeScript, Go, and more.
- [Stainless](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/sdks/stainless.md): Display autogenerated SDK code samples from Stainless in your API playground with type-safe examples across Python, TypeScript, and other SDKs.
- [Front](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/support/front.md): Integrate Front chat with your Mintlify documentation site so visitors can start customer support conversations directly from your docs pages.
- [Intercom](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/support/intercom.md): Integrate the Intercom chat widget into your Mintlify documentation site to provide real-time customer messaging, support, and onboarding help.
- [Support integrations](https://mintlify-docs-automation-github-pr-review.mintlify.app/integrations/support/overview.md): Connect your Mintlify documentation to support platforms like Intercom and Front so visitors can get live help directly from your docs pages.
- [Migrate to Mintlify](https://mintlify-docs-automation-github-pr-review.mintlify.app/migration.md): Migrate your documentation to Mintlify from Docusaurus, ReadMe, GitBook, or another platform with step-by-step instructions and CLI tooling.
- [Analytics](https://mintlify-docs-automation-github-pr-review.mintlify.app/optimize/analytics.md): Track documentation analytics in the Mintlify dashboard to understand page views, visitor trends, search queries, and content effectiveness.
- [Feedback](https://mintlify-docs-automation-github-pr-review.mintlify.app/optimize/feedback.md): Monitor user satisfaction with built-in feedback widgets, page ratings, and thumbs up/down reactions to identify documentation improvement areas.
- [PDF exports](https://mintlify-docs-automation-github-pr-review.mintlify.app/optimize/pdf-exports.md): Export your entire documentation site as a single PDF with a navigable table of contents for offline reading, sharing, and print distribution.
- [Search](https://mintlify-docs-automation-github-pr-review.mintlify.app/optimize/search.md): Configure the in-product search bar on your Mintlify documentation site, including ranking boosts and the number of results returned per query.
- [SEO](https://mintlify-docs-automation-github-pr-review.mintlify.app/optimize/seo.md): Configure meta tags, Open Graph properties, canonical URLs, and page-level SEO settings to improve your documentation's search engine ranking.
- [Hidden pages](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/hidden-pages.md): Hide documentation pages from the sidebar navigation while keeping them accessible via direct URL, search, or AI assistant for special use cases.
- [Exclude files from publishing](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/mintignore.md): Exclude specific files and directories from your published documentation using a .mintignore file with glob patterns, similar to .gitignore syntax.
- [Navigation](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/navigation.md): Configure your documentation site navigation with groups, pages, dropdowns, tabs, and anchors in docs.json to build a sidebar structure.
- [Pages](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/pages.md): Configure page metadata, titles, descriptions, icons, and layout modes using YAML frontmatter properties at the top of your MDX documentation.
- [Global settings](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings.md): Configure your Mintlify documentation site with docs.json, the required configuration file that controls navigation, appearance, integrations, and more.
- [API settings](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-api.md): Configure OpenAPI and AsyncAPI specs, the interactive API playground, SDK code examples, and authentication settings in your docs.json file.
- [Appearance and branding](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-appearance.md): Configure theme, colors, logo, favicon, fonts, and background in docs.json to control the visual identity of your documentation site.
- [Integrations](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-integrations.md): Connect analytics platforms, chat widgets, and third-party services to your Mintlify documentation site through the docs.json integrations config.
- [docs.json schema reference](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-reference.md): Complete reference for every docs.json configuration property with types, default values, descriptions, and usage examples for your docs site.
- [SEO and search](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-seo.md): Configure SEO settings in docs.json including site description, search engine indexing, meta tags, search bar placeholder, and page timestamps.
- [Site structure](https://mintlify-docs-automation-github-pr-review.mintlify.app/organize/settings-structure.md): Configure navbar, navigation groups, footer links, banner, contextual menu, redirects, and other structural elements in your docs.json file.
- [Quickstart](https://mintlify-docs-automation-github-pr-review.mintlify.app/quickstart.md): Get started with Mintlify by deploying your documentation site in minutes and making your first content change with the web editor or Git.
- [What is Mintlify?](https://mintlify-docs-automation-github-pr-review.mintlify.app/what-is-mintlify.md): Mintlify is a documentation platform designed for developers and AI, with smart search, interactive API playgrounds, and built-in analytics.