Invalidation

Invalidation ensures that users see the latest versions of your assets without outdated content being served from cache.

Invalidation is the process of removing outdated cached versions of assets from the Content Delivery Network (CDN) to ensure updates are visible to users.

DAM automatically invalidates the old version of the asset when a new version is created. Users with Developer, Manager, Administrator or Owner User Roles can perform invalidations manually.

Steps to perform Invalidation

  1. Click on the + Add Invalidation form button.

  2. Choose the Invalidation scope:

    1. Original - deletes the cache of individual assets.

      • Provide up to 5-10 URLs in format /folder1/folder2/filename.xxx (Example: /campaigns/winter_sale/banner.jpg).

      • Separate the URLs with commas or line breaks.

      • Do not include query string parameters at the end of the URL (e.g. ?w=600). These will be ignored during invalidation.

    2. All - deletes the entire cache of the project from the CDN and the resizing servers. Please pay notice that after invalidation the cache needs to rebuild again and the very first requests take more time for delivery.

When the Invalidation request is submitted, it appears in the Invalidation log. Both manual and automatic invalidations are logged there.

Details of the Invalidation request

Every request has the following parameters:

  • Invalidation ID - the unique identifier of the request

  • Scope - the scope of the request (original / all)

  • Date - the datetime when the request has been submitted for execution. The value is in the local time zone.

  • Status - the status of the request:

    • Received - request received successfully

    • Preparing - the Invalidation server prepares the request for execution

    • Flushing Scaleflex servers - deleting the cache in the resizing servers

    • Flushing CDN servers - deleting the cache of the CDN servers

    • Done - the invalidation finished successfully

    • ERROR_CDN_NODE - error in the CDN invalidation step

    • ERROR - general error in some of the invalidation steps

If you encounter ERROR or ERROR_CDN_NODE, retry or contact support.

  • Invalidation path - if you click on "See links", you can inspect which URLs have been requested for invalidation (applicable for the invalidations with scope "original")

  • Retry - you can retry the invalidation in case of need

Click the refresh icon (next to + Add Invalidation form) to reload the invalidation log and view the latest updates.

Invalidation API

You can automate this process using the Invalidation API. Refer to the API documentation for request format, authentication, and example use cases.

Last updated