All Products
Search
Document Center

Edge Security Acceleration:Purge cache by directory

Last Updated:Aug 21, 2025

Purging the cache by directory removes all cached content in a specific directory. This ensures that users can promptly access the latest versions of your files.

Scenarios

  • Purge all cached files in a specific directory, such as the /assets/images/ directory.

  • Update all content after a large-scale update to a module or section.

  • Purge all related resources after a project update or version release.

Procedure

  1. In the ESA console, select Websites, and then click the target site in the Website column.

  2. In the navigation pane on the left, choose Caching > Purge Cache.

  3. On the Refresh Cache tab, configure the purge rule.

    • Type: Select By Directory.

    • Refresh Method: Select whether to Mark As Expired or Delete.

      Refresh Input Method

      Description

      Manual Input

      In the input box, enter the URLs of the directories to refresh, one per line. Each URL must end with a /. You can enter up to 100 URLs at a time. For example:

      https://www.example.com/ 
      https://www.example.com/image/ 
      https://www.example.com/image/cat/ 

      Upload File

      If many URLs need to be purged, you can specify the URLs in a TXT file and then upload the file for batch purging. To purge a directory, the URL must be a directory path that ends with a /. List one URL per line. The size of the TXT file cannot exceed 10 MB.

    • Purge Method: Select Mark as Expired or Delete.

      • Mark as Expired

        If the requested content is one of the resources that you submit to purge, the nearest POP checks the Last-Modified parameter of the resource on the origin server. If the parameter value is the same as that of the cached resource, the POP serves the cached resource. Otherwise, the cached resource is considered expired. In this case, the POP fetches the latest version from the origin server, delivers it to the client, and updates the cache with the new version.

      • Delete

        If the requested content is one of the resources that you submit to purge, the nearest POP fetches the latest version from the origin server, delivers it to the client, and updates the cache with the new version.

    image

  4. Click Submit.

  5. View the purge progress.

    • You can view the progress and details of a purge task on the Purge Records tab. The purge task is complete when the progress reaches 100%. The duration varies based on the number of objects that you want to purge.

    • If you select Upload File for purging, you can view the upload status on the Upload Records tab. After the file is uploaded, the purge task starts. You can view the purging status of each file on the Purge Records tab.

      image

Different plans: support overview

Limit

Entrance

Pro

Premium

Enterprise

Daily directory purge quota (entries)

Not supported

100

1000

2000