Skip to content

Manage your subscription#

This page covers four things an organization owner does for a paid BSR subscription:

The two paid plans differ in where the BSR runs. Teams stays on the shared public BSR at buf.build. Pro provisions a dedicated private instance at <org>.buf.dev, where <org> is your BSR organization name. For features per plan, see buf.build/pricing.

Upgrade to Teams#

Teams removes the Community plan’s private-repository and type-count limits on the public BSR; usage is billed by billable type.

  1. Go to the Teams checkout.
  2. Sign up for a Buf account or log in.
  3. Select the organization to manage the subscription, or create a new one.
  4. Add a payment method. The 30-day trial begins immediately. After the trial, an email arrives with an estimate of the next month’s charges based on usage; you aren’t charged until the end of the first billing cycle after the trial.
  5. Review the configuration and click Complete.

Upgrade to Pro#

Pro provisions a dedicated private BSR instance at <org>.buf.dev with custom SSO (SAML or OIDC) and unlimited custom plugins.

  1. Go to the Pro checkout.
  2. Sign up for a Buf account or log in.
  3. Select the organization to manage the registry, or create a new one. The organization’s existing members are granted access to the new private instance, and the instance’s URL is derived from the organization name.
  4. Add a payment method. The 30-day trial begins immediately. After the trial, an email arrives with an estimate of the next month’s charges based on usage; you aren’t charged until the end of the first billing cycle after the trial.
  5. Review the configuration and click Create Registry.

The new registry is usually available within 30 minutes. For migrating modules and members onto the private instance, see the Pro migration guide.

Manage billing#

Subscription and billing settings live at:

https://buf.build/<org>/settings/subscription

You must be the owner of the organization to access this page. To navigate there from the BSR:

  1. Sign in to buf.build.
  2. Open the avatar menu at the top right and select Organizations.
  3. Select the organization you own, then Subscription in the left navigation.

View billing info#

From the Billing tab of the Subscription page, click View Billing Info. This opens the third-party billing portal Buf uses for self-serve subscriptions, where you can update card details, change billing email and tax info, and download invoices.

Configure usage alerts#

Teams and Pro organizations can have admins emailed when billable types cross a threshold. Set or change the threshold at:

https://buf.build/<org>/settings/usage

Enterprise instances bill on a different model and don’t use this alert.

Downgrade#

To downgrade to a smaller plan or cancel, open the Subscription page for your organization and click Cancel Subscription at the bottom. If you’re moving to a smaller paid plan rather than canceling outright, resubscribe to the target plan immediately afterward.

A few effects to plan for:

  • Teams customers fall under the Community plan limits right away.
  • Pro customers keep access to the private BSR instance for one week to export data; the instance is then deleted.
  • Prorated refunds aren’t offered, but you’ll be invoiced for prorated usage up to the cancellation date.

For the full procedure (including how to migrate modules off a Pro instance), see the FAQ.