Back to Supabase

Manage Branching usage

apps/docs/content/guides/platform/manage-your-usage/branching.mdx

1.26.043.7 KB
Original Source

What you are charged for

Each Preview branch is a separate environment with all Supabase services (Database, Auth, Storage, etc.). You're charged for usage within that environment—such as Compute, Disk Size, Egress, and Storage—just like the project you branched from.

<Admonition type="note">

Usage by Preview branches counts toward your subscription plan's quota. Branches are not covered by the Spend Cap.

</Admonition>

How charges are calculated

Refer to individual usage items for details on how charges are calculated. Branching charges are the sum of all these items.

Usage on your invoice

Compute incurred by Preview branches is shown as "Branching Compute Hours" on your invoice. Other usage items are not shown separately for branches and are rolled up into the project.

Pricing

<$Partial path="billing/pricing/pricing_branching.mdx" />

Billing examples

The project has a Preview branch "XYZ", that runs for 30 hours, incurring Compute and Egress costs. Disk Size usage remains within the 8 GB included in the subscription plan, so no additional charges apply.

Line ItemCosts
Pro Plan<Price price="25" />
Compute Hours Small Project 1<Price price="15" />
Egress Project 1<Price price="7" />
Disk Size Project 1<Price price="3" />
Compute Hours Micro Branch XYZ<Price price="0.4" />
Egress Branch XYZ<Price price="1" />
Disk Size Branch XYZ<Price price="0" />
Subtotal<Price price="51.4" />
Compute Credits-<Price price="10" />
Total<Price price="41.4" />

View usage

You can view Branching usage on the organization's usage page. The page shows the usage of all projects by default. To view the usage for a specific project, select it from the dropdown. You can also select a different time period.

<Image alt="Usage page navigation bar" src={{ light: '/docs/img/guides/platform/usage-navbar--light.png', dark: '/docs/img/guides/platform/usage-navbar--dark.png', }}

width={1546} height={208} />

In the Usage Summary section, you can see how many hours your Preview branches existed during the selected time period. Hover over "Branching Compute Hours" for a detailed breakdown.

<Image alt="Usage summary Branching Compute Hours" src={{ light: '/docs/img/guides/platform/usage-summary-branch-hours--light.png', dark: '/docs/img/guides/platform/usage-summary-branch-hours--dark.png', }}

width={2258} height={1360} />

Optimize usage

  • Merge Preview branches as soon as they are ready
  • Delete Preview branches that are no longer in use
  • Check whether your persistent branches need to be defined as persistent, or if they can be ephemeral instead. Persistent branches will remain active even after the underlying PR is closed.

FAQ

Do Compute Credits apply to Branching Compute?

No, Compute Credits do not apply to Branching Compute.