Cache Purging

PixelBin provides options to clear caches of a particular file or multiple files at the same time.

URLs purge / Organization purge

Steps to clear the cache

Navigate to the zones list within the dashboard.
Click on Purge Cache at the top right corner of the page.
Purge cache button click
Enter the file URLs for which you want to clear the cache. You can enter multiple URLs separated by a new line, and a maximum of 20 URLs can be submitted in a single request.
Purge cache form
Click on Purge to create a purge cache request. It will usually take a few minutes to clear depending on the size of the cache.

Purge cache for multiple URLs

You can purge the cache for multiple URLs either by listing down all the URLs or by appending the wildcard * character to the end of a directory.

Purge all organization cache

You can use the special characters /* to purge all the cache of an organization. When /* is one of the items in the URL list, then other URLs are ignored.

A URL to purge can be either a worker URL, a simple URL or a custom URL. A worker URL is differentiated by the wrkr keyword in the URL value. While a custom URL will use a custom domain for serving CDN files.

A URL must meet the following conditions to be valid:

A URL should be one of the following forms:

Pixelbin domain (Learn more)
- <domain>/<version>/<cloudname>/<transformation>/<fullpath>
- <domain>/<version>/<cloudname>/wrkr/<fullpath>
- <domain>/<version>/<cloudname>/<zone_slug>/<transformation>/<fullpath>
- <domain>/<version>/<cloudname>/<zone_slug>/wrkr/<fullpath>
Custom domain (Learn more)
- <custom_domain>/<version>/<transformation>/<fullpath>
- <custom_domain>/<version>/wrkr/<fullpath>
- <custom_domain>/<version>/<zone_slug>/<transformation>/<fullpath>
- <custom_domain>/<version>/<zone_slug>/wrkr/<fullpath>

Simple URL (domain and version omitted)
1. If a URL is complete, then it must not have a wildcard.
  ✅ /<transformation>/<directory_list>/<fullpath>
2. If a URL contains a wildcard, then the wildcard must appear at the end of a directory.
  ✅  /<transformation>/<directory_level_1>*
  ✅  /<transformation>/<directory_level_1>/<directory_level_2>*
  ❌  /<transformation>*
  ❌  /<transformation>/<fullpath>*
  ❌  /<transformation>/*/<fullpath>
Worker URL (domain and version omitted)
1. A worker URL cannot be used to purge multiple caches at the same time. (i.e., no wildcard * character)
2. The URL translation function of the zone should not be edited in between. This could lead to orphan files and the only way to remove these files would be to purge all.

Click Purge and allow a few minutes for the cache to clear. It would be best if you refresh the dashboard to get the updated cache clear status.

caution

If any one URL is invalid, the request will be rejected.

Paths purge / Zone purge

note

The cache can only be purged by paths at the zone level. Click here to learn more about zones.

Steps to clear the cache

Navigate to one of the zones within the dashboard.
Click on Purge Cache at the top right corner of the page.
Purge cache button click
Enter the file paths for which you want to clear the cache. You can enter multiple paths separated by a new line, and a maximum of 20 paths can be submitted in a single request.
Purge cache form
Click on Purge to create a purge cache request. It will usually take a few minutes to clear depending on the size of the cache.

Purge cache for multiple files

You can purge the cache for multiple files either by listing down all the paths or by appending the wildcard * character to the end of a directory.

Purge all zone cache

You can use the special characters /* to purge all the cache of a zone. When /* is one of the items in the URL list, then other paths are ignored.

A path to purge can be either a worker path or a simple path. A worker path is differentiated by the wrkr keyword in the path value.

A path must meet the following conditions to be valid:

Simple path
1. A path should start with a forward slash /.
2. A path must contain the applied transformation or the original keyword.
3. If a path is complete, then it must not have a wildcard.
  ✅ /<transformation>/<directory_list>/<fullpath>
4. If a path contains a wildcard, then the wildcard must appear at the end of a directory.
  ✅  /<transformation>/<directory_level_1>*
  ✅  /<transformation>/<directory_level_1>/<directory_level_2>*
  ❌  /<transformation>*
  ❌  /<transformation>/<fullpath>*
  ❌  /<transformation>/*/<fullpath>
Worker path
1. A path should start with /wrkr. (e.g., /wrkr/<oldpath>)
2. A worker path cannot be used to purge multiple caches at the same time. (i.e., no wildcard * character)
3. The URL translation function of the zone should not be edited in between. This could lead to orphan files and the only way to remove these files would be to purge all.

Click Purge and allow a few minutes for the cache to clear. It would be best if you refresh the dashboard to get the updated cache clear status.

caution

If any one path is invalid, the request will be rejected.

danger

Clearing the cache through the dashboard does not clear the cache within the user's browser. It only removes the cache for the URLs at the CDN and PixelBin's internal cache. The browser cache is cleared only when the file associated with the URL expires or is forcefully cleared by the end user.