Skip to main content

Projects

Dashboard Projects View

A project corresponds to a codebase that uses Convex, which contains a production deployment and one personal deployment for each team member.

Clicking on a project in the landing page will redirect you to project details.

Creating a project​

Projects can be created from the dashboard or from the CLI with npx convex dev. To create a project from the dashboard click on the Create Project button.

Project Settings​

You can access project-level settings by clicking on the triple-dot ⋮ button on each Project card on the Projects page.

Project card menu

On the Project Settings page, you can:

  • Update your project's name and slug.
  • Manage the project's Admins. See Roles and Permissions for more details.
  • View the amount of usage metrics your project has consumed.
  • Manage custom domains for your production deployment (in Deployment Settings).
  • Generate deploy keys for your production deployment (in Deployment Settings) and preview deployments.
  • Create and edit default environment variables.
  • View instructions to regain access to your project, should you lose track of your CONVEX_DEPLOYMENT config.
  • Permanently delete the project.
Project settings

Transferring a project to another team​

You can move a project to another team you’re a member of from the Project Settings page. The project keeps its slug, deployments, data, environment variables, and deploy keys — only its owning team changes.

After the transfer, the project URL changes from https://dashboard.convex.dev/t/<old-team>/<project> to https://dashboard.convex.dev/t/<new-team>/<project>. Members of the source team lose access to the project, unless they have permissions on the new team allowing them to see the project.

Transfer project

To transfer a project:

  • You need to be an admin on the source team (or have the project:transfer permission if using custom roles)
  • You also need to be an admin on the destination team (or have the project:receive permission if using custom roles).

Deleting a project​

To delete a project, click on the triple-dot ⋮ button on the Project card and select "Delete". You may also delete your project from the Project Settings page.

Once a project is deleted, it cannot be recovered. All deployments and data associated with the project will be permanently removed. When deleting a project from the dashboard, you will be asked to confirm the deletion. Projects with activity in the production deployment will have additional confirmation steps to prevent accidental deletion.

Delete project