How to Manage the Spaces CDN Cache

Spaces is an S3-compatible object storage service that lets you store and serve large amounts of data. Each Space is a bucket for you to store and serve files. The free, built-in Spaces CDN minimizes page load times, improves performance, and reduces bandwidth and infrastructure costs.

After you enable the Spaces CDN, the CDN’s edge servers will begin caching and serving the contents of the Space.

Each request with a unique URL, including the URL’s query string, is treated as a unique asset and has its own cache. Requests with identical URLs will return the same cached value. For example, the caches for the following two URLs are separate because the query strings are different:



There are two ways you can control the CDN cache:

  • Set the edge cache TTL. The edge cache TTL determines how long the CDN’s edge servers keep a particular copy of your files before getting the current version from the origin. A longer TTL gives better performance with the tradeoff that users won’t see updated content until the existing content expires.

    You may want to set a longer TTL for static content and content that is not not changed often. You may want to use a shorter TTL for dynamic content and content that changes frequently. You may also want to set a longer edge cache TTL if you anticipate a large increase in traffic.

  • Purge the cache. Purging files from the CDN cache makes all edge servers immediately clear their versions of those files and request the current version from Spaces.

    You may want to purge files to quickly correct errors, fully remove deleted content, or deploy urgent fixes.

Set the Edge Cache TTL

You can set the default edge cache TTL for the entire Space and customize the TTL for specific files.

Change the Space’s Default Edge Cache TTL

The edge cache TTL for Spaces is set to 1 hour by default. You can change this when you first enable the CDN and modify it at any time after.

To change a Space’s edge cache TTL from the control panel, navigate to the Space’s detail page by clicking the name of the Space. From there, click on the Settings tab. In the CDN (Content Delivery Network) section, click Edit to open the options.

The Settings tab for a Space with CDN settings opened

In the Edge Cache TTL drop-down menu, choose a time. The options are:

  • 1 minute
  • 10 minutes
  • 1 hour (the default)
  • 1 day
  • 1 week

After you make your choice, click Save.

Customize the Edge Cache TTL for Specific Files

If you want the TTL for specific files to differ from the default of the Space, you can add a custom key-value pair to the file’s metadata.

From the file’s More menu (or, after selecting multiple files, from the Actions menu), choose Manage Metadata. Click Add Custom Pairing, and enter max-age as the Key and the TTL you want in seconds as the Value. Then, click Save.

Purge Files from the Cache

You can purge individual files, recursively purge folders, or purge the entire contents of a Space using the same method. From the control panel, navigate to the Space’s detail page by clicking the name of the Space. This will bring you to the Files tab.

To purge a single item from the cache, open its More menu and select Purge from CDN Cache. To purge multiple items, select the items you want to purge, then open the Action menu and select Purge from CDN Cache. You can select the full contents of the Space by clicking the checkbox in the header, to the left of the Name column.

Either way, you’ll see a prompt to confirm the purge:

The confirmation window to purge files from the cache

Click Purge Item/Selected/Space from CDN Cache. (The text will vary depending on if you’ve selected a single item, multiple items, or the entire contents of the Space.) Clicking this button will send the invalidation request to the CDN edge servers.

For an alternative way to recursively purge folder contents or the entire Space from the CDN cache, navigate to the Space’s Settings tab. In the CDN (Content Delivery Network) section, click Purge Cache.

The Purge Cache window to purge selected directories from a Space

Here, you can choose a single directory or the entire space to remove the files they contain from the cache. After you make your selection, click Purge Selected Directories to send the invalidation request to the edge servers.