Overview
Understanding the relationship between databases, branches, and clusters is key to understanding your billing:- Database: Your overall project (e.g., “my-ecommerce-app”)
- Branch: Isolated database deployments that provide you with separate environments for development and testing, as well as restoring from backups. Learn more about branching
- Cluster: The underlying compute and storage infrastructure that powers each branch
- You are billed for the compute and storage resources (cluster) that power each branch (prorated to the millisecond each month)
- Every database branch you launch has default included amounts of:
- Usage beyond the included defaults is charged based on the costs for that resource, this includes:
- Cluster disk storage used beyond the included amount (for network-attached storage)
- Backup storage used beyond the included amount
- Network egress beyond the included amount
- Additional replicas
- Dedicated PgBouncer instances
Query live prices with SQL
Cluster SKU prices are available in a public, read-only Postgres table:public.planetscale_prices. You and your agent can query live prices with SELECT.
The role can only SELECT on that table. SSL is required. Connect through PgBouncer:
product (Postgres or Vitess), provider, region, machine_sku, replication_factor, and disk_sku (empty string for PS-* network-attached SKUs). price is the monthly cluster cost in whole USD. It does not include extra storage, backups, egress, dedicated PgBouncers, or extra replicas.
Not every SKU exists in every region. If a query returns no rows, that configuration is not sold there. Do not invent a price. Vitess SKUs in this catalog are mostly x86; there is no
PS-160-ARM Vitess row.pricing.md
For an agent-friendly catalog of live cluster SKU rates and example SQL, fetch
https://planetscale.com/pricing.md.For information on Vitess cluster pricing on the Base plan, see Base plan cluster pricing.
Cluster instance size
Each database branch runs on its own dedicated cluster infrastructure. Clusters are billed based on the selected instance size and prorated to the millisecond. Each instance size includes defined amounts of vCPU cores and memory, as well as storage based on the storage type selected (network-attached storage or PlanetScale Metal). The dashboard and pricing calculator show the current monthly rate for each size. How that rate is applied is described under cluster pricing. You can increase or decrease your cluster size at any time. Pricing is prorated to the millisecond, so if you temporarily increase, you will only be charged for the larger cluster size for the time that it was running. Billing for a modified cluster size begins once the resize is completed. You can also spin up additional production branches at any time for additional cost. The pricing for these is also prorated.Cluster disk storage
Storage types explained
PlanetScale offers two storage options with different pricing models:Network-attached storage billing
For network-attached storage clusters, pricing varies by region and cloud provider:- Base storage: you manually configure this in cluster settings, unless autoscaling is enabled
- Additional IOPS: you manually configure this in cluster settings (AWS only)
- Additional Throughput: you manually configure this in cluster settings (AWS only)
AWS gp3 and GCP Hyperdisk Balanced bill provisioned IOPS and throughput above their included baselines. GCP PD-SSD has volume-only pricing, with performance determined by disk size.
- IOPS (Input/Output Operations Per Second): How many read/write operations your database can handle per second. Higher IOPS = faster response for many small database queries.
- Throughput: How much data can be transferred per second (MiB/s). Higher throughput = faster for large data operations like bulk imports.
These defaults apply to all PS-series cluster sizes (PS-5 through PS-2560). You only pay additional IOPS or throughput charges if you manually configure values above these baselines.
For more information on changing your cluster’s storage, see the Cluster storage configuration documentation.
Backups
Included backup storage
PlanetScale automatically includes backup storage with every database branch at no extra cost. Each branch gets backup storage equal to 2x your disk size. Examples:For clusters with network-attached storage with autoscaling enabled, backup storage changes as your disk storage autoscales.
How backup billing works
Storage calculation: Both database data backups and WAL files are automatically compressed before being sent to backup storage. You’re billed only on the compressed size, which is typically much smaller than your active database size. Backup storage usage billing data is updated hourly. For more details on backup functionality, see Back up and restore. What affects storage costs:Network data transfer
Public traffic
Outgoing network traffic (egress) is billed based on the amount of data transferred out of PlanetScale Postgres instances to any other host or destination. You are not charged for data transfer associated with replicating data between primaries and replicas or backups. Each branch has a default amount of included public network egress that is aggregated for all cluster instances in the entire branch.
Fetch the current public egress rate for a region from the
/www/egress-rates endpoint. Pass a supported region identifier in the region query parameter.
Incoming public network traffic (ingress) is free.
Private traffic
For databases using private connections (AWS PrivateLink or GCP Private Service Connect), all network traffic over that connection — both egress and ingress — is charged at a flat rate of $0.01/GB, regardless of region. This replaces the standard regional egress pricing for traffic routed over private connections. Each branch has a default amount of included private network traffic that is aggregated for all cluster instances in the entire branch.Additional replicas
Each production cluster includes 2 replicas (excluding Single Node) to provide high availability and additional read capacity alongside the primary. Certain read-heavy workloads may demand additional read replicas. If you need additional replicas beyond what is included, you can add them for an additional cost based on the branch’s instance size and storage requirements. The cost of an additional replica instance is about one third of the highly available SKU rate. New replica billing begins once the change has completed. Replicas with network-attached storage do not receive the 10 GB included disk allowance. You pay for the full configured disk size on each extra replica, plus any IOPS or throughput you provision above the baselines. Development branches and Single Node databases do not support replicas. See Replicas.Cluster pricing
The dashboard and pricing calculator show the monthly SKU rate for each cluster size in your region. That rate is applied as follows:- Single Node — you pay the single-node SKU rate for the time that size is running.
- Highly Available — you pay the highly available SKU rate, which covers one primary and two replicas.
- Resizes — billing for the new size starts when the resize completes and is prorated to the millisecond.
- Metal — local NVMe storage is included in the Metal SKU rate. Network-attached storage is billed separately, as described under Cluster disk storage.
planetscale_prices table. See Query live prices with SQL.
Storage pricing
Network-attached storage is billed per database instance. The primary and two replicas in an HA cluster each use the configured volume, IOPS, and throughput. Additional replicas use another full copy of the configured volume and do not receive the 10 GB included allowance. For storage types with an included allowance, monthly volume cost before proration is:
Volume rates vary by region. Fetch the current rate from the
/www/storage-rates endpoint:
- AWS regions return the gp3 volume rate.
- GCP regions return the Hyperdisk Balanced volume rate by default.
- Add
pd-ssd=truefor the GCP PD-SSD volume rate, for examplegcp-us-central1&pd-ssd=true.
PgBouncer pricing
The local PgBouncer on the primary is included in the cluster SKU rate. A dedicated PgBouncer is a separate SKU. Its cost is the selected size’s monthly rate multiplied by the configured PgBouncers per availability zone, prorated for the time each configuration runs.
The dashboard and pricing calculator show the current monthly rate for each size in your region. See PgBouncer.

