Skip to main content
Projects in Mintlify are the containers for your documentation. Each project has its own content, settings, analytics, and publishing history. This guide shows you how to create a project and manage its settings so your docs are organized and accessible.

​
Create a project

1

Open the project creation flow

From the Dashboard, click New project in the top-right corner. You can also use the ? shortcut and select Create project.
2

Choose a template

Select a starter template (API docs, product guide, or changelog) or start from scratch with a blank project. Templates include pre-configured navigation and sample pages.
3

Name your project

Enter a project name and an optional description. The name appears in the project list and in the default URL (your-team.mintlify.app/your-project).
4

Set initial visibility

Choose Public if you want the docs to be accessible to anyone, or Private to restrict access to invited workspace members. You can change this later in project settings.
5

Confirm and create

Click Create project. Mintlify initializes the repository and opens the editor so you can start writing immediately.

​
Project settings

After creation, open a project and go to Settings to configure the following:
  • Visibility: Switch between Public and Private. Public projects are indexed by search engines unless you disable indexing in workspace settings.
  • Custom domain: Assign a domain like docs.example.com to this project. See Setup for DNS instructions.
  • Analytics: Enable or disable page-level analytics and set up conversion tracking for key calls to action.
Deleting a project permanently removes all pages, analytics, and publishing history. This action cannot be undone. Consider exporting your content first if you may need it later.
Once your project is configured, invite teammates to collaborate and start publishing your documentation.