Skip to main content
Your Mintlify organization contains one or more projects. Each project is either docs or a base. Organization members can work in every project, so the same team can maintain your public documentation and your internal knowledge base.

​
Project types

Both project types use the same editor, agent, and admin MCP, so editing content on either is the same experience. And both project types store their pages in a Git repository.

​
Create a project

When you sign up for Mintlify, you create your first project. You can add another project to your organization from your dashboard.
1

Create a new project

  1. Click the project switcher at the top of the left sidebar.
  2. Click New project.
2

Choose a project type

  1. Select Docs or Base.
  2. For docs, enter a Site address.
  3. Click Continue.
3

Set up the project

  1. Select how you plan to make updates: Web editor, Local development, or MCP. This selection is only for the initial setup. You can use every method in the project later.
  2. Click Create project.

​
Switch projects

  1. Click the project switcher at the top of the left sidebar.
  2. Select a project.

​
Copy pages between projects

To reuse a page in another project, such as a base page you want to publish in your docs, open its options menu and select Copy to a project. The copy is independent of the original. For details, see Copy a page to another project.