Delivery cache

CDN Cache Header Planner

Choose resource types and get Cache-Control suggestions. Hashed files can be immutable; HTML and private APIs should revalidate or avoid shared cache.

Ready100/100

Rules6

immutable2

no-store1

Issues0

Resource types

Hashed file names can use a one-year immutable cache. HTML and auth APIs should not.

Static file namesHTML strategy

The plan stays in this browser. It is not uploaded.

Suggested headers

Copy the Cache-Control value onto the matching path in your CDN or origin.

Type	Match	Cache-Control
Hashed JS/CSS/images	`/assets/.[hash].`	`public, max-age=31536000, immutable`
HTML documents	`/`	`public, max-age=0, must-revalidate`
Private API	`/api/*`	`private, no-store`
Fonts	`/fonts/*.[hash].woff2`	`public, max-age=31536000, immutable`
Unhashed images	`/images/*`	`public, max-age=86400, stale-while-revalidate=604800`
Sitemap XML	`/sitemap*.xml`	`public, max-age=3600, stale-while-revalidate=86400`

Nginx

location /assets/*.[hash].* {
  add_header Cache-Control "public, max-age=31536000, immutable";
}

location / {
  add_header Cache-Control "public, max-age=0, must-revalidate";
}

location /api/* {
  add_header Cache-Control "private, no-store";
}

location /fonts/*.[hash].woff2 {
  add_header Cache-Control "public, max-age=31536000, immutable";
}

location /images/* {
  add_header Cache-Control "public, max-age=86400, stale-while-revalidate=604800";
}

location /sitemap*.xml {
  add_header Cache-Control "public, max-age=3600, stale-while-revalidate=86400";
}

Vercel

{
  "headers": [
    {
      "source": "/assets/:path*\\.[hash]\\.:path*",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "public, max-age=31536000, immutable"
        }
      ]
    },
    {
      "source": "/",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "public, max-age=0, must-revalidate"
        }
      ]
    },
    {
      "source": "/api/:path*",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "private, no-store"
        }
      ]
    },
    {
      "source": "/fonts/:path*\\.[hash]\\.woff2",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "public, max-age=31536000, immutable"
        }
      ]
    },
    {
      "source": "/images/:path*",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "public, max-age=86400, stale-while-revalidate=604800"
        }
      ]
    },
    {
      "source": "/sitemap:path*\\.xml",
      "headers": [
        {
          "key": "Cache-Control",
          "value": "public, max-age=3600, stale-while-revalidate=86400"
        }
      ]
    }
  ]
}

CDN Cache Header Planner

Resource types

Suggested headers

Nginx

Vercel

Only query what is needed

Quick workflow

Useful tip

Suggested next steps

Browser Cache Policy Checker

HTTP Headers Checker

Asset Naming Convention Checker

Launch Readiness Scorecard

You might also like

DMARC Record Generator

Resource Hint Conflict Checker

Preload Preconnect Hint Generator

IP Checker

Regex Tester

Collection Page SEO Checklist

Email Unsubscribe Checker

Base32 Encoder/Decoder