LiteSpeed Cache icon
Performance & Caching

LiteSpeed Cache hooks reference

  • By LiteSpeed Technologies
  • v7.9.3
  • Updated

LiteSpeed Cache 7.9.3 has 73 actions and 105 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when LiteSpeed Cache fires an action
add_action( 'litespeed_nonce', function( $arg1 ) {
	// Your code runs here.
}, 10, 1 );

// Change a value LiteSpeed Cache is about to use
add_filter( 'litespeed_qs_forbidden', function( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • thirdparty/divi-theme-builder.cls.php line 95 · used in 8 places
    /**
     * Add contact form to nonce.
     */
    do_action( 'litespeed_nonce', 'et-pb-contact-form-submit' );
  • src/core.cls.php line 229 · used in 2 places
    /**
     * Check if is non-optimization simulator
     */
    apply_filters( 'litespeed_qs_forbidden', false );
  • src/vary.cls.php line 578 · used in 2 places
    /**
     * Filter vary entries before hashing.
     */
    apply_filters( 'litespeed_vary', $vary );
  • src/crawler-map.cls.php line 629
    /**
     * Filter the hosts the crawler may fetch from the sitemap (non drop-domain
     * mode).
     */
    apply_filters( 'litespeed_crawler_sitemap_hosts', array_values( array_unique( $hosts ) ) );
  • src/img-optm-manage.trait.php line 140
    /**
     * Limit images each time before redirection to fix Out of memory issue.
     * #665465
     */
    apply_filters( 'litespeed_imgoptm_destroy_max_rows', 500 );
  • src/core.cls.php line 200
    /**
     * Added hook before init 3rd party preload hooks will be fired here too (e.g.
     * Divi disable all in edit mode)
     */
    do_action( 'litespeed_init' );
  • src/media.cls.php line 1561
    /**
     * WebP/AVIF API hook. NOTE: As $url may contain query strings, check filters
     * which may parse_url before appending format.
     */
    apply_filters( 'litespeed_media_check_ori', Utility::is_internal_file( $url ), $url );
  • src/media.cls.php line 1307
    /**
     * Exclude parent classes.
     */
    apply_filters( 'litespeed_media_iframe_lazy_parent_cls_excludes', $this->conf( Base::O_MEDIA_IFRAME_LAZY_PARENT_CLS_EXC ) );
  • src/media.cls.php line 415
    /**
     * WP Stateless compatibility #143
     * https://github.com/litespeedtech/lscache_wp/issues/143
     */
    apply_filters( 'litespeed_media_info', [], $short_file_path, $post_id );
  • src/media.cls.php line 1092
    /**
     * Exclude list.
     */
    apply_filters( 'litespeed_media_lazy_img_excludes', $this->conf( Base::O_MEDIA_LAZY_EXC ) );
  • src/media.cls.php line 1111
    /**
     * Exclude parent classes.
     */
    apply_filters( 'litespeed_media_lazy_img_parent_cls_excludes', $this->conf( Base::O_MEDIA_LAZY_PARENT_CLS_EXC ) );
  • src/purge.cls.php line 692
    /**
     * Fires when _add() extends the public purge list, before header delivery or
     * queue storage.
     */
    do_action( 'litespeed_purged', $tags, $purge2 );
  • src/file.cls.php line 93
    /**
     * Filters the generated static-directory .htaccess content.
     */
    apply_filters( 'litespeed_static_dir_htaccess', $content );
  • src/vary.cls.php line 267
    /**
     * Allow bypassing pending comment check for comment plugins.
     */
    apply_filters( 'litespeed_vary_check_commenter_pending', true );
  • litespeed-cache.php line 183
    /**
     * This filter is documented in wp-includes/pluggable.php
     */
    apply_filters( 'nonce_user_logged_out', $uid, $action );
  • src/router.cls.php line 207
    /**
     * Bypass post/page link setting
     */
    apply_filters( 'rest_url_prefix', 'wp-json' );
  • src/api.cls.php line 196 · used in 16 places
    do_action( 'litespeed_debug', '[API] Disabled_all due to ' . $reason );
  • thirdparty/nextgengallery.cls.php line 59 · used in 15 places
    do_action( 'litespeed_purge', self::CACHETAG_GALLERIES . $image->galleryid );
  • src/doc.cls.php line 27 · used in 8 places
    apply_filters( 'litespeed_conf', $id );
  • thirdparty/bbpress.cls.php line 52 · used in 8 places
    do_action( 'litespeed_control_set_nocache', 'bbpress nocache due to loggedin' );
  • thirdparty/bbpress.cls.php line 82 · used in 6 places
    do_action( 'litespeed_purge_post', $ancestor );
  • thirdparty/autoptimize.cls.php line 41 · used in 5 places
    do_action( 'litespeed_purge_all', '3rd Autoptimize' );
  • thirdparty/divi-theme-builder.cls.php line 46 · used in 4 places
    do_action( 'litespeed_disable_all', 'divi edit mode' );
  • src/control.cls.php line 658 · used in 3 places
    apply_filters( 'litespeed_const_DONOTCACHEPAGE', DONOTCACHEPAGE );
  • thirdparty/bbpress.cls.php line 46 · used in 3 places
    apply_filters( 'litespeed_control_cacheable', false );
  • thirdparty/bbpress.cls.php line 31 · used in 3 places
    apply_filters( 'litespeed_esi_status', false );
  • thirdparty/bbpress.cls.php line 89 · used in 3 places
    do_action( 'litespeed_purge_widget', $replies_widget->id );
  • src/img-optm-pull.trait.php line 96 · used in 3 places
    apply_filters( 'litespeed_realpath', $file );
  • thirdparty/nextgengallery.cls.php line 222 · used in 3 places
    do_action( 'litespeed_tag_add', $tag . $id );
  • thirdparty/woocommerce.cls.php line 960 · used in 2 places
    do_action( 'litespeed_conf_append', self::O_UPDATE_INTERVAL, false );
  • src/crawler.cls.php line 1134 · used in 2 places
    apply_filters( 'litespeed_crawler_disable_blocklist', false, $url );
  • thirdparty/woocommerce.cls.php line 400 · used in 2 places
    apply_filters( 'litespeed_esi_url', 'storefront-cart-header', 'STOREFRONT_CART_HEADER' );
  • src/crawler-map.cls.php line 608 · used in 2 places
    apply_filters( 'litespeed_internal_domains', [] );
  • src/control.cls.php line 806 · used in 2 places
    apply_filters( 'litespeed_is_mobile', false );
  • src/media.cls.php line 441 · used in 2 places
    do_action( 'litespeed_media_del', $short_file_path, $post_id );
  • src/media.cls.php line 460 · used in 2 places
    do_action( 'litespeed_media_rename', $short_file_path, $short_file_path_new, $post_id );
  • src/optimizer.cls.php line 104 · used in 2 places
    apply_filters( 'litespeed_ucss_per_pagetype', false );
  • src/ucss.cls.php line 185 · used in 2 places
    apply_filters( 'litespeed_ucss_url', $request_url );
  • src/data.cls.php line 543 · used in 2 places
    apply_filters( 'litespeed_url_file_expired_days', 20 );
  • src/cdn/quic.cls.php line 67 · used in 2 places
    apply_filters( 'litespeed_vary_cookies', array() );
  • nonce_life

    filter
    src/esi.cls.php line 950 · used in 2 places
    apply_filters( 'nonce_life', DAY_IN_SECONDS, $action );
  • tpl/page_optm/settings_media.tpl.php line 21
    apply_filters( 'big_image_size_threshold', 2560, [], '', 0 );
  • src/esi.cls.php line 1023
    apply_filters( 'do_shortcode_tag', $output, $shortcode, $atts_ori, $matches );
  • src/cloud-queue-svc.cls.php line 115
    apply_filters( "litespeed_{$this->_svc_id()}_priority", $is_front_page, $request_url );
  • src/base.cls.php line 1123
    apply_filters( "litespeed_{$type}", $css, $queue_k );
  • thirdparty/aelia-currencyswitcher.cls.php line 41
    apply_filters( 'litespeed_3rd_aelia_cookies', self::$_cookies );
  • src/admin.cls.php line 85
    do_action( 'litespeed_after_admin_init' );
  • src/purge.cls.php line 1391
    do_action( 'litespeed_api_purge_post', $post_id );
  • src/avatar.cls.php line 275
    apply_filters( 'litespeed_avatar_limit', 30 );
  • src/htaccess.cls.php line 148
    apply_filters( 'litespeed_backend_htaccess', $this->backend_htaccess );
  • src/gui.cls.php line 1042
    do_action( 'litespeed_backend_shortcut' );
  • src/core.cls.php line 578
    apply_filters( 'litespeed_buffer_after', $buffer );
  • src/core.cls.php line 490
    apply_filters( 'litespeed_buffer_before', $buffer );
  • src/core.cls.php line 511
    apply_filters( 'litespeed_buffer_finalize', $buffer );
  • src/metabox.cls.php line 68
    apply_filters( 'litespeed_bypass_metabox', false, $post_type );
  • src/router.cls.php line 218
    apply_filters( 'litespeed_can_cdn', $can );
  • src/vary.cls.php line 404
    apply_filters( 'litespeed_can_change_vary', true );
  • src/router.cls.php line 138
    apply_filters( 'litespeed_can_optm', $can );
  • src/css.cls.php line 233
    apply_filters( 'litespeed_ccss_url', $request_url );
  • src/css.cls.php line 261
    apply_filters( 'litespeed_ccss_whitelist', $this->conf( self::O_OPTM_CCSS_SELECTOR_WHITELIST ) );
  • src/cdn.cls.php line 90
    apply_filters( 'litespeed_cdn_auto_managed_filetypes', [ Base::CDN_MAPPING_INC_IMG => [ '.jpg', '.jpeg', '.png', '.gif', '.svg', '.webp', '.avif' ], Base::CDN_MAPPING_INC_CSS => [ '.css' ], Base::CDN_MAPPING_INC_JS => [ '.js' ], ] );
  • thirdparty/woocommerce.cls.php line 343
    apply_filters( 'litespeed_clean_wrapper_end', '' );
  • src/core.cls.php line 546
    apply_filters( 'litespeed_comment', $running_info_showing );
  • thirdparty/woocommerce.cls.php line 958
    do_action( 'litespeed_conf_multi_switch', self::O_UPDATE_INTERVAL, 3 );
  • src/control.cls.php line 784
    do_action( 'litespeed_control_finalize', defined( 'LSCACHE_IS_ESI' ) ? LSCACHE_IS_ESI : false );
  • thirdparty/yith-wishlist.cls.php line 146
    do_action( 'litespeed_control_set_private', 'yith wishlist' );
  • thirdparty/woocommerce.cls.php line 547
    do_action( 'litespeed_control_set_ttl', $ttl, "WooCommerce set scheduled TTL to $ttl" );
  • thirdparty/woocommerce.cls.php line 546
    apply_filters( 'litespeed_control_ttl', 0 );
  • src/crawler.cls.php line 1314
    apply_filters( 'litespeed_crawler_cookies', $this->conf( Base::O_CRAWLER_COOKIES ) );
  • tpl/crawler/settings.tpl.php line 187
    do_action( 'litespeed_crawler_cookies_after' );
  • src/crawler.cls.php line 1272
    apply_filters( 'litespeed_crawler_webp', false );
  • tpl/toolbox/log_viewer.tpl.php line 54
    apply_filters( 'litespeed_debug_show_max_lines', 1000 );
  • src/purge.cls.php line 705
    apply_filters( 'litespeed_delay_purge', false );
  • thirdparty/yith-wishlist.cls.php line 120
    do_action( 'litespeed_esi_combine', 'yith_wcwl_add' );
  • src/esi.cls.php line 503
    apply_filters( 'litespeed_esi_control', $control, $block_id );
  • src/esi.cls.php line 431
    apply_filters( "litespeed_esi_inline-{$esi_id}", array(), $esi_param );
  • src/esi.cls.php line 489
    do_action( "litespeed_esi_load-{$block_id}", $params );
  • src/esi.cls.php line 713
    do_action( "litespeed_esi_load-{LSCACHE_IS_ESI}", $params );
  • src/esi.cls.php line 142
    apply_filters( 'litespeed_esi_nonces', $nonces );
  • src/esi.cls.php line 502
    apply_filters( 'litespeed_esi_params', $params, $block_id );
  • src/esi.cls.php line 229
    do_action( "litespeed_esi_shortcode-{$atts[0]}" );
  • src/optimizer.cls.php line 227
    apply_filters( 'litespeed_font_optimize_value', 'swap' );
  • src/htaccess.cls.php line 147
    apply_filters( 'litespeed_frontend_htaccess', $this->frontend_htaccess );
  • src/gui.cls.php line 823
    do_action( 'litespeed_frontend_shortcut' );
  • src/optimizer.cls.php line 38
    apply_filters( 'litespeed_html_min', true );
  • src/media.cls.php line 1343
    apply_filters( 'litespeed_iframe_lazyload_exc', false, $attrs['src'] );
  • src/img-optm-send.trait.php line 130
    apply_filters( 'litespeed_imgoptm_new_req_interval', 3600 );
  • src/img-optm.cls.php line 195
    apply_filters( 'litespeed_imgoptm_sizes_skipped', $this->conf( Base::O_IMG_OPTM_SIZES_SKIPPED ) );
  • src/core.cls.php line 216
    do_action( 'litespeed_initing' );
  • src/tool.cls.php line 191
    apply_filters( 'litespeed_is_editor', $res );
  • src/core.cls.php line 567
    apply_filters( 'litespeed_is_json', false );
  • src/media.cls.php line 952
    apply_filters( 'litespeed_lazyload_threshold', 300 );
  • src/core.cls.php line 401
    do_action( 'litespeed_load_thirdparty' );
  • src/media.cls.php line 1121
    apply_filters( 'litespeed_media_add_missing_sizes', true );
  • src/media.cls.php line 1564
    apply_filters( 'litespeed_media_check_webp', Utility::is_internal_file( $url, $this->_sys_format ), $url );
  • src/media.cls.php line 1291
    apply_filters( 'litespeed_media_iframe_lazy_cls_excludes', $this->conf( Base::O_MEDIA_IFRAME_LAZY_CLS_EXC ) );
  • src/media.cls.php line 1250
    apply_filters( 'litespeed_media_ignore_remote_missing_sizes', true );
  • src/media.cls.php line 1094
    apply_filters( 'litespeed_media_lazy_img_cls_excludes', $this->conf( Base::O_MEDIA_LAZY_CLS_EXC ) );
  • src/media.cls.php line 539
    do_action( 'litespeed_media_row', $post_id );
  • src/placeholder.cls.php line 180
    do_action( 'litespeed_media_row_lqip', $post_id );
  • src/media.cls.php line 81
    apply_filters( 'litespeed_next_gen_format', $this->_format );
  • src/optimax.cls.php line 387
    apply_filters( 'litespeed_optimax', $content, $queue_k );
  • src/optimax.cls.php line 197
    apply_filters( 'litespeed_optimax_exc', $this->conf( self::O_OPTIMAX_EXC ) );
  • src/optimax.cls.php line 160
    apply_filters( 'litespeed_optimax_per_pagetype', false );
  • src/optimax.cls.php line 233
    apply_filters( 'litespeed_optimax_url', $request_url );
  • src/optimize.cls.php line 1037
    apply_filters( 'litespeed_optimize_css_excludes', $this->conf(self::O_OPTM_CSS_EXC) );
  • src/optimize.cls.php line 849
    apply_filters( 'litespeed_optimize_js_excludes', $this->conf(self::O_OPTM_JS_EXC) );
  • src/optimize.cls.php line 1038
    apply_filters( 'litespeed_optimize_ucss_file_exc_inline', $this->conf(self::O_OPTM_UCSS_FILE_EXC_INLINE) );
  • src/optimize.cls.php line 269
    do_action( 'litespeed_optm' );
  • src/optimize.cls.php line 1044
    apply_filters( 'litespeed_optm_css_comb_ext_inl', true );
  • src/optimize.cls.php line 1049
    apply_filters( 'litespeed_optm_css_to_be_removed', [] );
  • src/optimizer.cls.php line 285
    apply_filters( 'litespeed_optm_cssjs', $content, $file_type, $src );
  • src/optimize.cls.php line 100
    apply_filters( 'litespeed_optm_gm_js_exc', $this->conf(self::O_OPTM_GM_JS_EXC) );
  • src/optimize.cls.php line 449
    apply_filters( 'litespeed_optm_html_after_head', false );
  • src/optimize.cls.php line 457
    apply_filters( 'litespeed_optm_html_foot', $this->html_foot );
  • src/optimize.cls.php line 447
    apply_filters( 'litespeed_optm_html_head', $this->html_head );
  • src/optimize.cls.php line 443
    apply_filters( 'litespeed_optm_html_head_early', $this->html_head_early );
  • src/optimize.cls.php line 852
    apply_filters( 'litespeed_optm_js_comb_ext_inl', true );
  • src/optimize.cls.php line 109
    apply_filters( 'litespeed_optm_js_defer_exc', $this->conf(self::O_OPTM_JS_DEFER_EXC) );
  • src/optimize.cls.php line 220
    apply_filters( 'litespeed_optm_uri_exc', $this->conf(self::O_OPTM_EXC) );
  • thirdparty/yith-wishlist.cls.php line 61
    do_action( 'litespeed_purge_esi', 'yith_wcwl_add' );
  • src/purge.cls.php line 1210
    do_action( 'litespeed_purge_finalize' );
  • src/purge.cls.php line 98
    apply_filters( 'litespeed_purge_post_events', [ 'delete_post', 'wp_trash_post', 'wp_update_comment_count', ] );
  • src/purge.cls.php line 1383
    apply_filters( 'litespeed_purge_post_skip_non_viewable', true, $post_id );
  • thirdparty/bbpress.cls.php line 76
    do_action( 'litespeed_purge_posttype', bbp_get_forum_post_type() );
  • thirdparty/woocommerce.cls.php line 187
    do_action( 'litespeed_purge_private_all' );
  • thirdparty/woocommerce.cls.php line 165
    do_action( 'litespeed_purge_private_esi', 'storefront-cart-header' );
  • src/purge.cls.php line 1307
    apply_filters( 'litespeed_purge_tags', $purge_tags, $is_private );
  • src/purge.cls.php line 844
    do_action( 'litespeed_purge_ucss', $url_tag );
  • src/purge.cls.php line 273
    do_action( 'litespeed_purged_all' );
  • src/purge.cls.php line 462
    do_action( 'litespeed_purged_all_avatar' );
  • src/purge.cls.php line 319
    do_action( 'litespeed_purged_all_ccss' );
  • src/purge.cls.php line 512
    do_action( 'litespeed_purged_all_cssjs' );
  • src/purge.cls.php line 485
    do_action( 'litespeed_purged_all_localres' );
  • src/purge.cls.php line 410
    do_action( 'litespeed_purged_all_lqip' );
  • src/purge.cls.php line 301
    do_action( 'litespeed_purged_all_lscache' );
  • src/purge.cls.php line 626
    do_action( 'litespeed_purged_all_object' );
  • src/purge.cls.php line 582
    do_action( 'litespeed_purged_all_opcache' );
  • src/purge.cls.php line 361
    do_action( 'litespeed_purged_all_optimax' );
  • src/purge.cls.php line 340
    do_action( 'litespeed_purged_all_ucss' );
  • src/purge.cls.php line 432
    do_action( 'litespeed_purged_all_vpi' );
  • src/purge.cls.php line 936
    do_action( 'litespeed_purged_cat', $value );
  • src/purge.cls.php line 1169
    do_action( 'litespeed_purged_comment_widget', $recent_comments->id );
  • src/purge.cls.php line 1070
    do_action( 'litespeed_purged_esi', $tag );
  • src/purge.cls.php line 1183
    do_action( 'litespeed_purged_feeds' );
  • src/purge.cls.php line 821
    do_action( 'litespeed_purged_front', $ref );
  • src/purge.cls.php line 867
    do_action( 'litespeed_purged_frontpage' );
  • src/purge.cls.php line 1194
    do_action( 'litespeed_purged_on_logout' );
  • src/purge.cls.php line 883
    do_action( 'litespeed_purged_pages' );
  • src/purge.cls.php line 1122
    do_action( 'litespeed_purged_post', $pid );
  • src/purge.cls.php line 1084
    do_action( 'litespeed_purged_posttype', $post_type );
  • src/purge.cls.php line 802
    do_action( 'litespeed_purged_single' );
  • src/purge.cls.php line 967
    do_action( 'litespeed_purged_tag', $val );
  • src/purge.cls.php line 1148
    do_action( 'litespeed_purged_widget', $widget_id );
  • thirdparty/woocommerce.content.tpl.php line 55
    do_action( 'litespeed_setting_enroll', $setting_id );
  • tpl/cache/entry.tpl.php line 140
    do_action( 'litespeed_settings_content', 'cache' );
  • tpl/cache/entry.tpl.php line 121
    do_action( 'litespeed_settings_tab', 'cache' );
  • thirdparty/woocommerce.cls.php line 366
    do_action( 'litespeed_tag_add_post', $related );
  • src/tag.cls.php line 330
    do_action( 'litespeed_tag_finalize' );
  • src/esi.cls.php line 354
    do_action( 'litespeed_tpl_normal' );
  • src/ucss.cls.php line 137
    apply_filters( 'litespeed_ucss_exc', $this->conf( self::O_OPTM_UCSS_EXC ) );
  • src/ucss.cls.php line 262
    apply_filters( 'litespeed_ucss_whitelist', $this->conf( self::O_OPTM_UCSS_SELECTOR_WHITELIST ) );
  • src/conf.cls.php line 674
    do_action( 'litespeed_update_confs', $the_matrix );
  • thirdparty/wcml.cls.php line 64
    do_action( 'litespeed_vary_ajax_force' );
  • src/vary.cls.php line 737
    apply_filters( 'litespeed_vary_curr_cookies', $cookies );
  • thirdparty/yith-wishlist.cls.php line 147
    do_action( 'litespeed_vary_no' );
  • src/vpi.cls.php line 132
    apply_filters( 'litespeed_vpi_should_queue', true, $request_url );
  • src/vpi.cls.php line 155
    apply_filters( 'litespeed_vpi_url', $request_url );
  • tpl/esi_widget_edit.php line 25
    apply_filters( 'litespeed_widget_default_options', $options, $widget );
  • src/activation.cls.php line 560
    apply_filters( 'litespeed_wpconfig_readonly', false );
  • src/esi.cls.php line 1020
    apply_filters( 'pre_do_shortcode_tag', false, $shortcode, $atts_ori, $matches );
  • thirdparty/woocommerce.cls.php line 828
    apply_filters( 'wpml_active_languages', null );
  • thirdparty/woocommerce.cls.php line 817
    apply_filters( 'wpml_element_trid', false, $wpml_purge_id, $type );
  • thirdparty/woocommerce.cls.php line 816
    apply_filters( 'wpml_element_type', get_post_type( $wpml_purge_id ) );
  • thirdparty/woocommerce.cls.php line 818
    apply_filters( 'wpml_get_element_translations', [], $trid, $type );
  • wpml_setting

    filter
    thirdparty/wpml.cls.php line 43
    apply_filters( 'wpml_setting', false, 'language_domains' );

Generated from LiteSpeed Cache's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: