This page describes how you can check your bandwidth usage and changes you can make if you notice unexpectedly high bandwidth usage on your Builder Subscription dashboard.
To check your bandwidth usage:
- Go to your Space settings.
- Click the Subscription tab.
- Click the Bandwidth section of the page.
- Change the dropdown to be View by request.
This view provides details on which URLs are using the most amount of your Space's bandwidth.
The most common causes of unexpectedly high bandwidth are detailed below, along with their solutions.
The most common cause is having cacheSeconds set to 0, which disables CDN caching. This means every server render downloads the full payload again instead of reusing cached responses.
To solve for this, increase or set the cacheSeconds value on highly viewed pages.
{
options: {
cacheSeconds: 600, // Enable 10-minute caching
includeRefs: true,
format: 'json',
}
}Using includeRefs: true inlines all referenced entries into the response, significantly increasing payload size for large or deeply nested content.
Only use includeRefs when absolutely needed to reduce bandwidth.
When targeting is enabled by default, it can reduce cache reuse for content that should be global, such as navigation menus.
For global content, set noTargeting to true.
{
options: {
noTargeting: true,
cacheSeconds: 600,
}
}Using cachebust: true in your API calls prevents caching and forces fresh requests every time.
Remove or set cachebust: false for production environments:
builder.getAll(modelName, {
// or remove this line entirely
cachebust: process.env.NODE_ENV === 'development',
//...
});In addition to the common issues detailed above:
- Review your codebase for any
builder.getAll()orfetchEntries()requests that might be called repeatedly. - Check for high-limit queries. Avoid using limits above 200 records as this can cause large responses.
- Monitor server logs to identify if APIs are being called excessively.
- Implement application-level caching using Next.js
unstable_cacheor similar frameworks.
If you still encounter issues with bandwidth after trying these solutions, reach out to support@builder.io.