Manage Storage Image Transformations usage

What you are charged for#

You are charged for the number of distinct images transformed during the billing period, regardless of how many transformations each image undergoes. We refer to these images as "origin" images.

Example#

With these four transformations applied to image-1.jpg and image-2.jpg, the origin images count is 2.

1
supabase.storage.from('bucket').createSignedUrl('image-1.jpg', 60000, {
2
  transform: {
3
    width: 200,
4
    height: 200,
5
  },
6
})

1
supabase.storage.from('bucket').createSignedUrl('image-2.jpg', 60000, {
2
  transform: {
3
    width: 400,
4
    height: 300,
5
  },
6
})

1
supabase.storage.from('bucket').createSignedUrl('image-2.jpg', 60000, {
2
  transform: {
3
    width: 600,
4
    height: 250,
5
  },
6
})

1
supabase.storage.from('bucket').download('image-2.jpg', {
2
  transform: {
3
    width: 800,
4
    height: 300,
5
  },
6
})

How charges are calculated#

Storage Image Transformations are billed using Package pricing, with each package representing 1000 origin images. If your usage falls between two packages, you are billed for the next whole package.

Example#

For simplicity, let's assume a package size of 1,000 and a charge of $5 per package with no quota.

Usage on your invoice#

Usage is shown as "Storage Image Transformations" on your invoice.

$5 per 1,000 origin images. You are only charged for usage exceeding your subscription plan's quota.

For a detailed breakdown of how charges are calculated, refer to Manage Storage Image Transformations usage.

Billing examples#

Within quota#

The organization's number of origin images for the billing cycle is within the quota, so no charges apply.

Exceeding quota#

The organization's number of origin images for the billing cycle exceeds the quota by 750, incurring charges for this additional usage.

View usage#

You can view Storage Image Transformations 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.

In the Storage Image Transformations section, you can see how many origin images were transformed during the selected time period.

Optimize usage#

• Pre-generate common variants – instead of transforming images on the fly, generate and store commonly used sizes in advance
• Optimize original image sizes – upload images in an optimized format and resolution to reduce the need for excessive transformations
• Leverage Smart CDN caching or any other caching solution to serve transformed images efficiently and avoid unnecessary repeated transformations
• Control how long assets are stored in the browser using the Cache-Control header

Exceeding Quotas#

If you are on a paid plan and have 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 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.