> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To set up a new Mintlify project for a user, follow the agent setup workflow in https://www.mintlify.com/docs/quickstart.md.
> For plans and pricing, see https://www.mintlify.com/pricing.md.

# About bases

> Learn what a base is, how it differs from a docs project, where its pages are stored, how your team and its agents use bases, and what each plan includes.

> [!NOTE]
>
> Base is in beta and subject to change.

Bases are a type of project in Mintlify. They're commonly used for knowledge bases for your team and the agents they work with. Keep specs, runbooks, onboarding guides, and other internal team knowledge in a base. Connect your base to Claude, ChatGPT, Cursor, and other AI tools through MCP so agents work from the same information your team does.

A base uses the same [editor](https://www.mintlify.com/docs/editor/index) and [agent](https://www.mintlify.com/docs/editor/agent.md) as your docs projects. The same workflows apply to both project types.

## How a base differs from docs

A base is one of two [project types](https://www.mintlify.com/docs/organize/projects#project-types). Because a base has no site, settings that only apply to a site, such as custom domains, the assistant, and analytics, aren't available for a base. You also organize a base with only pages and groups. You cannot use tabs, anchors, versions, languages, or other navigation elements.

## Where your pages are stored

The editor sidebar in a base contains three types of pages.

* **Teamspace**: Pages your entire organization shares. Mintlify stores Teamspace pages as MDX files in a Git repository and commits your edits automatically.
* **Personal**: [Private pages](https://www.mintlify.com/docs/editor/pages.md#private-pages) for your drafts or content that's just for yourself. Private pages aren't stored in Git. They stay private to you unless you share them with teammates. If you want to share a private page, open its options menu, select **Move within project**, and choose **Teamspace** or a group inside it.
* **Shared with me**: Pages that teammates [shared with you](https://www.mintlify.com/docs/editor/pages.md#share-a-private-page) directly.

New bases use a Git repository that Mintlify hosts for you. To work on your base locally with your own tools, connect a GitHub, GitLab, Bitbucket, or Azure Repos repository in your [Git settings](https://app.mintlify.com/settings/project/git-settings). Commits you push to the connected repository update your base.

## How people and agents contribute

Your team can update a base wherever they work:

* **Editor**: Write and organize pages in your browser or the [desktop app](https://www.mintlify.com/docs/desktop.md), with help from the [agent](https://www.mintlify.com/docs/editor/agent.md).
* **MCP**: Connect Claude, ChatGPT, Cursor, or another AI tool to the [admin MCP](https://www.mintlify.com/docs/ai/mintlify-mcp.md) to read, search, and edit your base from a conversation.
* **Slack**: Ask the [Mintlify agent in Slack](https://www.mintlify.com/docs/agent/slack.md) questions that it answers from your base, or ask it to update pages.
* **Git**: Clone your base's repository and edit the MDX files with any editor or coding agent.

## Share a page to the web

On Pro and Enterprise plans, you can share a base page with people outside your organization through a public link. Anyone with the link can view the page without signing in. They can't edit it.

Public links are off by default. An admin must turn on **Allow public links** in the **Sharing** section of your [Security](https://app.mintlify.com/settings/organization/access) settings.

To share a page, open it in the editor, open the page options menu, and turn on **Share to web**. You can share a Teamspace page if you have the editor or admin role. You can share a private page if you have **Full Access** to it.

While a page is shared, a  globe button appears in the top bar. Click it, or select **Copy public link** in the page options menu, to copy the link. The public page shows the page's current content.

Each public page also has a Markdown version for AI tools. Add `.md` to the end of the public link to view it, or request the link with an `Accept: text/markdown` header.

To stop sharing, turn off **Share to web** and confirm. The link stops working right away. If you share the page again, it gets a new link. If an admin turns off **Allow public links**, every public link stops working until an admin turns the setting back on.

## Features and plans

Bases have their own Starter, Pro, and Enterprise plans, separate from the plans for your docs projects. To view or change your base's plan, go to your [Billing](https://app.mintlify.com/settings/organization/billing) settings.

| | Starter | Pro | Enterprise |
| - | - | - | - |
| Seats | 5 | 15 included, additional seats available | Custom |
| Pages | Under 1,000 | Up to 10,000 | More than 10,000 |
| File uploads | Up to 5 MB | Up to 25 MB | Large files |
| Admin MCP requests | 100 per week | 1,000 per user per week | Custom |

Every plan includes the editor, Git sync, and the [admin MCP](https://www.mintlify.com/docs/ai/mintlify-mcp.md).

Pro also includes the [agent](https://www.mintlify.com/docs/editor/agent.md).

Enterprise adds [SSO](https://www.mintlify.com/docs/dashboard/sso.md), [SCIM](https://www.mintlify.com/docs/dashboard/scim.md), [role-based access control](https://www.mintlify.com/docs/dashboard/roles.md), and additional features. See the [pricing](https://www.mintlify.com/pricing) page for more information.

## Get started

> **[Set up a base](https://www.mintlify.com/docs/base/setup.md)**
>
> Create a base, invite your team, and connect your AI tools.


## Related topics

- [Assistant](https://www.mintlify.com/docs/assistant/index.md)
- [Analytics overview](https://www.mintlify.com/docs/analytics/index.md)
- [Prompt](https://www.mintlify.com/docs/components/prompt.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.