
# 

Manage Egress usage

* * *

## What you are charged for[#](#what-you-are-charged-for)

You are charged for the network data transmitted out of the system to a connected client. Egress is incurred by all services - Database, Auth, Storage, Edge Functions, Realtime and Log Drains.

### Database Egress[#](#database-egress)

Data sent to the client when retrieving data stored in your database.

**Example:** A user views their order history in an online shop. The client application requests the database to retrieve the user's past orders. The order data is sent back to the client, contributing to Database Egress.

There are various ways to interact with your database, such as through the PostgREST API using one of the client SDKs or via the Supavisor connection pooler. On the Supabase Dashboard, Egress from the PostgREST API is labeled as **Database Egress**, while Egress through Supavisor is labeled as **Shared Pooler Egress**.

### Auth Egress[#](#auth-egress)

Data sent from Supabase Auth to the client while managing your application's users. This includes actions like signing in, signing out, or creating new users, e.g. via the JavaScript Client SDK.

**Example:** A user signs in to an online shop. The client application requests the Supabase Auth service to authenticate and authorize the user. The session data, including authentication tokens and user profile details, is sent back to the client, contributing to Auth Egress.

### Storage Egress[#](#storage-egress)

Data sent from Supabase Storage to the client when retrieving assets. This includes actions like downloading files, images, or other stored content, e.g. via the JavaScript Client SDK.

**Example:** A user downloads an invoice from an online shop. The client application requests Supabase Storage to retrieve the PDF file from the storage bucket. The file is sent back to the client, contributing to Storage Egress.

### Edge Functions Egress[#](#edge-functions-egress)

Data sent to the client when executing Edge Functions.

**Example:** A user completes a checkout process in an online shop. The client application triggers an Edge Function to process the payment and confirm the order. The confirmation response, along with any necessary details, is sent back to the client, contributing to Edge Functions Egress.

### Realtime Egress[#](#realtime-egress)

Data pushed to clients via Supabase Realtime for subscribed events.

**Example:** When a user views a product page in an online shop, their client subscribes to real-time inventory updates. As stock levels change, Supabase Realtime pushes updates to all subscribed clients, contributing to Realtime Egress.

### Shared pooler Egress[#](#shared-pooler-egress)

Data sent to the client when using the shared connection pooler (Supavisor) to access your database. When using the shared connection pooler, we do not count database egress, as this would otherwise count double (Database -> Shared Pooler + Shared Pooler -> Client).

**Example:** You are using our [shared connection pooler](../../../database/connecting-to-postgres/index.md#shared-pooler) and you query a list of invoices in your backend. The data returned from that query is contributing to Shared Pooler Egress.

### Log Drain Egress[#](#log-drain-egress)

Data pushed to the connected log drain.

**Example:** You set up a log drain, each log sent to the log drain is considered egress. You can toggle the GZIP option to reduce egress, in case your provider supports it.

### Cached Egress[#](#cached-egress)

Cached and uncached egress have independent quotas and independent pricing. Cached egress is egress that is served from our CDN via cache hits. Cached egress is typically incurred for storage through our [Smart CDN](../../../storage/cdn/smart-cdn/index.md).

## How charges are calculated[#](#how-charges-are-calculated)

Egress is charged by gigabyte. Charges apply only for usage exceeding your subscription plan's quota. This quota is called the Unified Egress Quota because it can be used across all services (Database, Auth, Storage etc.).

### Usage on your invoice[#](#usage-on-your-invoice)

Usage is shown as "Egress GB" and "Cached Egress GB" on your invoice.

## Pricing[#](#pricing)

$0.09 per GB per month for uncached egress, $0.03 per GB per month for cached egress. You are only charged for usage exceeding your subscription plan's quota.

Plan

Egress Quota (Uncached / Cached)

Over-Usage per month (Uncached / Cached)

Free

5 GB / 5 GB

\-

Pro

250 GB / 250 GB

$0.09 per GB / $0.03 per GB

Team

250 GB / 250 GB

$0.09 per GB / $0.03 per GB

Enterprise

Custom

Custom

## Billing examples[#](#billing-examples)

### Within quota[#](#within-quota)

The organization's Egress usage is within the quota, so no charges for Egress apply.

Line Item

Units

Costs

Pro Plan

1

$25

Compute Hours Micro

744 hours

$10

Egress

200 GB

$0

Cached Egress

230 GB

$0

**Subtotal**

**$35**

Compute Credits

\-$10

**Total**

**$25**

### Exceeding quota[#](#exceeding-quota)

The organization's Egress usage exceeds the uncached egress quota by 50 GB and the cached egress quota by 550 GB, incurring charges for this additional usage.

Line Item

Units

Costs

Pro Plan

1

$25

Compute Hours Micro

744 hours

$10

Egress

300 GB

$4.5

Cached Egress

800 GB

$16.5

**Subtotal**

**$47.5**

Compute Credits

\-$10

**Total**

**$37.5**

## View usage[#](#view-usage)

### Usage page[#](#usage-page)

You can view Egress usage on the [organization's usage page](/dashboard/org/_/usage). 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.

![Usage page navigation bar](/docs/img/guides/platform/usage-navbar--light.png)

In the Total Egress section, you can see the usage for the selected time period. Hover over a specific date to view a breakdown by service. Note that this includes the cached egress.

![Unified Egress](/docs/img/guides/platform/unified-egress--light.png)

Separately, you can see the cached egress right below:

![Unified Egress](/docs/img/guides/platform/cached-egress--light.png)

### Custom report[#](#custom-report)

1.  On the [Observability page](/dashboard/project/_/observability), click **New custom report** in the left navigation menu
2.  After creating a new report, add charts for one or more Supabase services by clicking **Add block**

![Egress report](/docs/img/guides/platform/egress-report--light.png)

## Debug usage[#](#debug-usage)

To better understand your Egress usage, identify what’s driving the most traffic. Check the most frequent database queries, or analyze the most requested API paths to pinpoint high-egress endpoints.

### Frequent database queries[#](#frequent-database-queries)

On the Advisors [Query performance view](/dashboard/project/_/database/query-performance?preset=most_frequent&sort=calls&order=desc) you can see the most frequent queries and the average number of rows returned.

![Most frequent queries](/docs/img/guides/platform/advisor-most-frequent-queries--light.png)

### Most requested API endpoints[#](#most-requested-api-endpoints)

In the [Logs Explorer](/dashboard/project/_/logs/explorer) you can access Edge Logs, and review the top paths to identify heavily queried endpoints. These logs currently do not include response byte data. That data will be available in the future too.

![Top paths](/docs/img/guides/platform/logs-top-paths--light.png)

## Optimize usage[#](#optimize-usage)

*   Reduce the number of fields or entries selected when querying your database
*   Reduce the number of queries or calls by optimizing client code or using caches
*   For update or insert queries, configure your ORM or queries to not return the entire row if not needed
*   When running manual backups through Supavisor, remove unneeded tables and/or reduce the frequency
*   Refer to the [Storage Optimizations guide](../../../storage/production/scaling/index.md#egress) for tips on reducing Storage Egress

## Exceeding Quotas[#](#exceeding-quotas)

If you are on a paid plan and have [Spend Cap](../../cost-control/index.md#spend-cap) disabled or your organization is on Team Plan or above, you will pay for any overages.

When you are exceeding your quotas while being on a Free Plan or having [Spend Cap](../../cost-control/index.md#spend-cap) enabled, you will get a notification to your billing email address and put under a grace period. For more details, refer to our [Fair Use Policy](../../billing-faq/index.md#fair-use-policy).
