Skip to content

Black Friday 50% off your first year on all premium plugins and the Suite.

See the deals

Exclusions and views tab

Exclude URLs, query arguments, cookies and user agents from the cache, and keep separate copies for mobile, old browsers, languages, countries and users.

2 min read · Updated 5 November 2026

TurboCache → Settings → Exclusions and views decides which requests are never cached and which get their own cached copy.

Exclusions

Lists take one entry per line. Patterns can be an exact path, a substring, a prefix ending in *, or a regular expression wrapped in @…@.

  • URIs — never cached or optimised. Defaults: /checkout/, /cart/, /my-account/, anything containing “sitemap”, paginated URLs (/page/2/ and similar), URLs ending in a number segment, /wp-json/ and /feed/.
  • Query arguments — Any argument makes the page dynamic (recommended, default) or Only the listed arguments. Default list: sitemap, sitemap_n, elementor-preview, wc-ajax, et_fb, et_bfb, et_pb_preview.
  • Ignored arguments — tracking parameters stripped from the cache key so campaign links still hit the cache: utm_source, utm_medium, utm_campaign, utm_content, utm_term, fbclid, gclid, wbraid, gbraid, gad_source, _ga, yclid, mc_cid, mc_eid, ref, msclkid, ttclid, srsltid.
  • Cookies — name prefixes (or @regex@) that mark a personalised visitor: wp-postpass_, comment_author_, woocommerce_items_in_cart, edd_items_in_cart. The WordPress login cookie always bypasses unless logged-in caching is on.
  • User agents — default printfriendly.

Views

  • Mobile view (default on) — phones get their own optimised copy; tablets count as desktop. Off means one universal copy per page.
  • Mobile agents — user-agent fragments that count as mobile: mobile, android, silk/, blackberry, opera mini, opera mobi.

Compatibility view

Old browsers (default on) gives Internet Explorer, old Safari and some measurement bots an untouched copy without deferred scripts or critical CSS. Compat agents accepts substrings, @regex@, safari<VERSION or macos<VERSION.

View groups

Cookie / argument variants (default on) keeps a separate copy per value of the listed cookies or arguments instead of excluding those visitors. Format: Name | cookie prefixes (comma separated) | argument names. Defaults cover AMP, WPML, WPtouch, several WooCommerce currency switchers (VillaTheme, YITH, Aelia, FOX) and some cookie banners. Arguments listed here never make a page dynamic.

Geo views

  • By country (default off) — separate copies per country group. The country comes from the CDN or server header (Cloudflare, CloudFront, Vercel, mod_geoip) or from a MaxMind file.
  • Country groups — one per line, id | ISO codes, e.g. eu | DE,FR,IT,ES,NL; * catches every other country.
  • Custom header — optional request header carrying the ISO code.
  • MaxMind database — absolute server path to a GeoLite2/GeoIP2 Country .mmdb file, used when no header is present.

Users

  • Per-user cache (default off) — logged-in users get private cached copies, sent with Cache-Control: private and never shared. For membership sites, LMS and dashboards.
  • Separate sessions (default on) — one copy per login session rather than per user.
  • Cleanup timeout (default 1 day) — personal copies expire after this.

Data items

Cache data responses (default off) also caches non-HTML responses such as feeds, sitemaps and REST JSON. Rules: one per line, URI pattern | lifetime in minutes. Defaults: /feed/ | 60, @\.xml$@ | 60, /wp-json/wp/v2/* | 30. Query arguments are part of the key for these.

Did this answer the question? No — open a support request