-
Notifications
You must be signed in to change notification settings - Fork 0
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.
| 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_.
| 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 |
| 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 |
| 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 |
| Key | Default |
|---|---|
self_host_google |
false |
font_display |
swap |
| Key | Default | Notes |
|---|---|---|
enabled |
false |
|
url |
'' |
HTTPS origin-pull hostname |
file_types |
16 extensions | css, js, mjs, images, fonts |
| 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 |
| 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 |
| Key | Default |
|---|---|
fluentcart |
true |
edd |
true |
woocommerce |
true |
| Key | Default |
|---|---|
enabled |
false |
cart_count |
true |
account_link |
true |
| 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 |
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).
| Key | Default |
|---|---|
enabled |
false |
allow_imports |
true |
signing_secret |
'' (encrypted) |
policy_modules |
all 12 modules |
| Key | Default | Notes |
|---|---|---|
auto_protection |
true |
Auto-exclude detected analytics/consent plugins |
perfmatters_owner |
automatic |
Per-feature ownership arbitration |
akismet |
true |
|
jetpack |
true |
| Key | Default | Notes |
|---|---|---|
generation |
1 |
Bump to invalidate every key at once |
debug |
false |
Emits X-GT-Cache-Reason and debug logging |
GT Performance · GPL-2.0-or-later · Issues and pull requests welcome
Getting started
Caching
Optimization
Delivery
Operations
Reference