Skip to content

Pause a Pro or Team Plan project

Pause a project that belongs to an organization on the Pro Plan or Team Plan. Projects in these organizations can't be paused, so you transfer the project to a Free Plan organization and pause it there.

Prerequisites

Before you transfer a project to pause it, check the following:

  • You're an Owner or Administrator of a Free Plan organization. Other roles can't pause a project. To create an organization, open New organization.
  • The transfer runs every check in Project transfer requirements, including overdue invoices and the free project limit.
  • To pause the project with the Management API, you have an access token. A scoped token needs access to the Free Plan organization or to the project, and Project Settings with Read-write access.

Procedure

To pause the project, follow these steps:

  1. Transfer the project to the Free Plan organization, with the steps in Transfer a project.

  2. Pause the project. In the project's general settings, click Pause project. With the Management API, use the pause a project endpoint, and replace YOUR_PROJECT_REF and YOUR_ACCESS_TOKEN with your values:

    curl -X POST "https://api.supabase.com/v1/projects/YOUR_PROJECT_REF/pause" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

    On the Free Plan, you can resume a paused project only if its database is 1 GB or smaller. To resume a larger project, first transfer the paused project to an organization on the Pro Plan and above. You can transfer a project that's already paused, and it stays paused after the transfer.

The transfer doesn't change the subscription of the organization that the project leaves, so that organization still pays its plan fee. See Billing.

Next steps

After you pause the project, use these pages: