Skip to main content
ModPageSpeed 2.0 and mod_pagespeed 1.1 — Coming Soon

Directive Index

Alphabetical reference of all mod_pagespeed 1.1 configuration directives with Apache and nginx syntax, default values, and links to full documentation.

All mod_pagespeed 1.1 directives are listed alphabetically below. In Apache, prefix each directive name with ModPagespeed (e.g., ModPagespeedEnableFilters). In nginx, prefix with pagespeed and terminate with a semicolon (e.g., pagespeed EnableFilters ...;).

DirectiveDefaultDescriptionDocs
AddResourceHeader(none)Adds custom header to optimized resourcesConfiguration
AdminDomainsAllow *ACL for admin page accessAdmin Console
Allow(none)Allows optimization of resources matching a URL patternDomain Configuration
AdminPath/pagespeed_adminURL path for admin pages (nginx)Admin Console
CacheFlushFilenamecache.flushFilename for legacy cache flushCaching
CacheFlushPollIntervalSec5Interval to check for flush fileCaching
CacheFragment(auto)Cache partition keyCaching
ConsoleDomainsAllow *ACL for console accessAdmin Console
ConsolePath/pagespeed_consoleURL path for console (nginx)Admin Console
CriticalImagesBeaconEnabledonEnables beacon for image optimizationImage Filters
CssFlattenMaxBytes102400Max size for flattened CSSCSS Filters
CssImageInlineMaxBytes0Max image size to inline in CSSCSS Filters
CssInlineMaxBytes2048Max CSS file size to inlineCSS Filters
CssOutlineMinBytes3000Min inline CSS to externalizeCSS Filters
DefaultSharedMemoryCacheKB50000Shared memory metadata cache sizeCaching
Disallow(none)Prevents optimization of resources matching a URL patternDomain Configuration
DisableFilters(none)Disables specific filtersFilter Selection
DisableRewriteOnNoTransformonHonors Cache-Control: no-transformConfiguration
Domain(none)Authorizes a domain for resource fetchingDomain Configuration
EnableCachePurgeoffEnables per-URL cache purgeCaching
EnableFilters(none)Enables specific filtersFilter Selection
FetcherTimeoutMs5000Timeout for resource fetchesCaching
FetchHttps(off)Enables HTTPS resource fetchingHTTPS Configuration
FetchWithGzipoffFetches resources with gzip Accept-EncodingCaching
FileCachePath(required)Path for file-based cache storageCaching
FileCacheSizeKb102400Maximum file cache size in KBCaching
ForbidAllDisabledFiltersoffForbids all non-enabled filtersFilter Selection
ForbidFilters(none)Permanently disables specific filtersFilter Selection
GlobalAdminDomainsAllow *ACL for global admin accessAdmin Console
GlobalStatisticsDomainsAllow *ACL for global statistics accessAdmin Console
GlobalAdminPath/pagespeed_global_adminURL path for global admin (nginx)Admin Console
GlobalStatisticsPath(nginx path)URL for global stats (nginx)Admin Console
HonorCspoffRespects Content-Security-Policy headersConfiguration
HttpCacheCompressionLevel9Compression level for cached HTTP responsesCaching
ImageInlineMaxBytes3072Max image size to inline as data URIImage Filters
ImageLimitOptimizedPercent100Only serve if optimized is smallerImage Filters
ImageMaxRewritesAtOnce8Parallel image optimization limitImage Filters
ImageRecompressionQuality85Image recompression qualityImage Filters
ImageResolutionLimitBytes32000000Max image size to optimizeImage Filters
ImplicitCacheTtlMs300000Cache TTL for resources without explicit headersCaching
InPlaceResourceOptimizationonEnables IPROCaching
InPlaceRewriteDeadlineMs10IPRO rewrite deadline per flushCaching
InPlaceSMaxAgeSec10s-maxage for IPRO responsesCaching
JpegRecompressionQuality-1JPEG quality (-1 = use general)Image Filters
JsInlineMaxBytes2048Max JS file size to inlineJavaScript Filters
JsOutlineMinBytes3000Min inline JS to externalizeJavaScript Filters
ListOutstandingUrlsOnErroroffShows fetch URLs in error responsesConfiguration
LoadFromFile(none)Loads resources from filesystemDomain Configuration
LoadFromFileCacheTtlMs(ImplicitCacheTtlMs)Cache TTL for filesystem-loaded resourcesCaching
LogDir(none)Directory for statistics loggingAdmin Console
LowercaseHtmlNamesoffLowercases HTML tag/attribute namesConfiguration
LRUCacheByteLimit16384Max entry size for LRU cacheCaching
LRUCacheKbPerProcess1024/8192LRU cache size per processCaching
MapOriginDomain(none)Maps public domain to origin for fetchingDomain Configuration
MapProxyDomain(none)Proxies and optimizes content from a separate originDomain Configuration
MapRewriteDomain(none)Rewrites resource URLs to another domainDomain Configuration
MemcachedServers(none)Memcached server listCaching
MemcachedTimeoutUs500000Memcached operation timeoutCaching
MessageBufferSize0Size of message history bufferAdmin Console
MessagesDomainsAllow *ACL for message historyAdmin Console
MessagesPath(nginx path)URL for messages (nginx)Admin Console
ModifyCachingHeadersonSets caching headers on HTMLConfiguration
PreserveUrlRelativityoffPreserves relative URLsConfiguration
PurgeMethod(none)HTTP method for cache purgeCaching
RateLimitBackgroundFetchesonRate-limits background fetchesCaching
RedisDatabaseIndex0Redis database indexCaching
RedisReconnectionDelayMs1000Redis reconnection delayCaching
RedisServer(none)Redis server addressCaching
RedisTimeoutUs50000Redis operation timeoutCaching
RedisTTLSec-1Redis entry TTLCaching
RespectVaryoffRespects Vary headers on resourcesConfiguration
RetainComment(none)Wildcard pattern for comments to keepHTML Filters
RewriteDeadlinePerFlushMs10Rewrite timeout per HTML flushCaching
RewriteLevelCoreFiltersBaseline filter setFilter Selection
RewriteRandomDropPercentage0Random percentage of rewrites to skipFilter Selection
ShardDomain(none)Distributes resources across domainsDomain Configuration
ShmMetadataCacheCheckpointIntervalSec300Checkpoint interval for shm cacheCaching
SslCertDirectory(none)SSL certificate directoryHTTPS Configuration
SslCertFile(none)SSL certificate fileHTTPS Configuration
StaticAssetPrefix/pagespeed_static/URL prefix for static assetsConfiguration
StatisticsonEnables statistics collectionAdmin Console
StatisticsDomainsAllow *ACL for statistics accessAdmin Console
StatisticsLoggingoffEnables logging for console graphsAdmin Console
StatisticsPath(nginx path)URL for statistics (nginx)Admin Console
SupportNoScriptEnabledonInserts noscript redirectTroubleshooting
UsePerVhostStatisticsoffPer-virtual-host statisticsAdmin Console
WebpRecompressionQuality80WebP quality levelImage Filters
XHeaderValue(version)X-Mod-Pagespeed/X-Page-Speed header valueConfiguration

See also