Cache Tag Visibility determines how Cache Tags are returned to the client on a request for content.

Features and options

The Cache Tags applied to requested content are returned to the client based on these options:

• Do not return Cache Tags. Cache Tags applied to the requested content aren’t returned.

• Return Cache Tags only when Pragma header is sent. Cache Tags applied to the requested content are returned only when you pass a Pragma: akamai-x-get-cache-tags header as part of the request.

• Return Cache Tags with every request. Cache Tags applied to the requested content are returned in all responses.

Any Cache Tags that are applied to the requested content are returned to the requesting client in a single Edge-Cache-Tag response header, whether they were originally applied to the requested content via an Edge-Cache-Tag response header from your origin, or via the Cache Tag behavior.

👍

Cache tags can include back-end information, or at least allow a malicious user to decipher back-end information from them. To help with this, you can set this to Return Cache Tags only when Pragma header is sent. It can limit the return of cache tags by requiring the Pragma: akamai-x-get-cache-tags header in a request. If you are using Enhanced Debug and you have disabled Pragma debugging, you should pass the cache option in the Akamai-Debug request header instead. For example, Akamai-Debug: {auth-token} cache.

View the Cache Tags applied to content

Here's an example curl request with the Pragma header added, which allows Cache Tags to be returned if the Return Cache Tags only when Pragma header is sent option is specified:

curl -k -S -s -D - -H "Pragma: akamai-x-get-cache-tags" "https://www.akamaicustomer.com/items/sale/womens-jackets/"

Here's the response, including an Edge-Cache-Tag header showing the Cache Tags that are applied to the selected page:

HTTP/1.1 200 OK
Content-Type: text/html
Content-Length: 1359
Expires: Thu, 25 Sep 2025 15:27:03 GMT
Cache-Control: max-age=0, no-cache, no-store
Edge-Cache-Tag: womens, jackets, sale-2025
Pragma: no-cache
Date: Thu, 25 Sep 2025 15:27:03 GMT
Connection: keep-alive

This indicates that the requested /items/sale/womens-jackets/ page had the womens, jackets, and sale-2025 Cache Tags applied.