Skip to content

Settings Reference

Gaurav Tiwari edited this page Aug 27, 2026 · 1 revision

Settings Reference

Every setting, its default, and what it changes. Stored in one option, gt_performance_settings, and compiled to config.json.php for the drop-in.

cache

Key Default Notes
enabled true Origin caching. Inactive until the drop-in is installed
post_publish_purge related post | related | all | none
fresh_ttl 3600 Seconds served as HIT
stale_ttl 86400 Seconds past fresh, served as STALE
browser_ttl 300 max-age sent to the browser
stale_if_error 86400 stale-if-error for shared caches
ignored_query_params 9 tracking params Stripped from the key; page still cached
bypass_query_params 9 entries Force a bypass
bypass_paths 5 entries Matched on segment boundaries
bypass_cookies 4 prefixes Prefix match on cookie name
separate_mobile false Adds a mobile key variant
preload true Queue stale rebuilds
preload_max_urls 200 Cap per warming run

Defaults: ignored — fbclid, gclid, gbraid, msclkid, utm_campaign, utm_content, utm_medium, utm_source, utm_term. Bypassed — add-to-cart, customize_changeset_uuid, elementor-preview, fluent-cart, preview, s, wc-ajax, gtperf_verify, gtperf_css_preview. Paths — /wp-admin/, /wp-login.php, /wp-cron.php, /wp-json/, /xmlrpc.php. Cookies — comment_author_, wordpress_logged_in_, wordpress_no_cache, wp-postpass_.

css

Key Default Notes
enabled false
mode file file | inline | hybrid
critical_budget 14336 Bytes; hybrid falls back to a file above this
keep_dynamic_states true Match :hover etc. against the base element
rollout_percent 100 Share of visitors receiving optimized CSS
trained_selectors [] Published from Training Mode
safelist [] Selector fragments always kept
excluded_stylesheets [] Skip whole stylesheets by URL fragment

javascript

Key Default Notes
minify false Same-origin, non-.min.js, under 2 MB
defer false
delay false Until first interaction. Highest risk
delay_patterns 5 analytics hosts Match patterns, not connections
exclusions [] URL fragments

media

Key Default Notes
lazy_load true
add_dimensions true Injects width/height to reduce layout shift
critical_images 2 Leading images excluded from lazy-loading
optimize_uploads false Generate variants on upload
rewrite_variants false Serve generated variants
format webp webp | avif
compression 82
youtube_previews false Lightweight facade until click
lazy_render_selectors [] content-visibility targets

fonts

Key Default
self_host_google false
font_display swap

cdn

Key Default Notes
enabled false
url '' HTTPS origin-pull hostname
file_types 16 extensions css, js, mjs, images, fonts

cloudflare

Key Default Notes
enabled false
auth_mode token token | global
zone_id, domain ''
api_token, global_api_key, email '' Encrypted at rest
edge_ttl 86400
drift_hash '' Detects policy drift

redis

Key Default
enabled false
host 127.0.0.1
port 6379
database 0
username, password '' (encrypted)
tls false
persistent true
prefix '' (auto per site)
connection_timeout 0.5
read_timeout 0.5

commerce

Key Default
fluentcart true
edd true
woocommerce true

private_fragments

Key Default
enabled false
cart_count true
account_link true

database

Key Default Notes
enabled false
schedule weekly daily | weekly | monthly
retain_revisions 5
tasks 7 tasks revisions, auto_drafts, spam_comments, trashed_posts, trashed_comments, expired_transients, optimize_tables

bloat

Twenty-four independent switches, all conservative by default: disable_emojis, disable_dashicons, disable_embeds, disable_xmlrpc, remove_rsd_link, remove_jquery_migrate, hide_wp_version, remove_shortlink, disable_rss_feeds, remove_feed_links, disable_self_pingbacks, disable_rest_api (default | disabled), remove_rest_api_links, disable_google_maps + google_maps_exclusions, disable_password_strength_meter, disable_comments, remove_comment_urls, blank_favicon, remove_global_styles, separate_block_styles, heartbeat_mode (reduce), heartbeat_seconds (60), limit_revisions (5), autosave_interval (60).

fleet

Key Default
enabled false
allow_imports true
signing_secret '' (encrypted)
policy_modules all 12 modules

integrations

Key Default Notes
auto_protection true Auto-exclude detected analytics/consent plugins
perfmatters_owner automatic Per-feature ownership arbitration
akismet true
jetpack true

Top level

Key Default Notes
generation 1 Bump to invalidate every key at once
debug false Emits X-GT-Cache-Reason and debug logging

Related

Constants Reference · Page Cache · Fleet Console

Clone this wiki locally