How to Manage the Spaces CDN Cache

After you enable the Spaces CDN, the CDN’s edge servers will begin caching and serving the contents of the Space. There are two ways you can control this 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 click 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 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 for the Spaces CDN

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.