Skip to main content

Overview

A project is part of an organization that has a base branch and child branches. Projects serve as containers for your database environments, allowing you to organize and manage multiple development and production environments under a single project umbrella. Project overview interface

Create Project

Create a new project to start managing your database environments and branches. Create project interface

From the CLI

Create a project using the Xata CLI:
# Create a new project
xata project create --name "my-app" --organization "org-id"
For more CLI commands, see the CLI Reference.

Configure Compute

Configure compute resources for your project including scale-to-zero capabilities and manual hibernation options. For detailed information about compute configuration, scaling, and resource management, see Compute Resources.

Default Database

Set a default database for your project to streamline access and operations. This feature allows you to select which database should be automatically selected within each branch. If the database does not exist in the branch, it will default to app. Default database selection interface

Delete Project

Delete a project and all its associated resources. Important: All branches must be deleted before a project can be deleted.

From the CLI

Delete a project using the Xata CLI:
# Delete a project (requires confirmation)
xata project delete --project "project-id"
For more CLI commands, see the CLI Reference.
I