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.
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
.mmdbfile, used when no header is present.
Users
- Per-user cache (default off) — logged-in users get private cached copies, sent with
Cache-Control: privateand 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