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.
// 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
-
litespeed_nonce
action/** * Add contact form to nonce. */ do_action( 'litespeed_nonce', 'et-pb-contact-form-submit' ); -
litespeed_qs_forbidden
filter/** * Check if is non-optimization simulator */ apply_filters( 'litespeed_qs_forbidden', false ); -
litespeed_vary
filter/** * Filter vary entries before hashing. */ apply_filters( 'litespeed_vary', $vary ); -
/** * 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 ) ) ); -
/** * Limit images each time before redirection to fix Out of memory issue. * #665465 */ apply_filters( 'litespeed_imgoptm_destroy_max_rows', 500 ); -
litespeed_init
action/** * 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' ); -
litespeed_media_check_ori
filter/** * 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 ); -
/** * Exclude parent classes. */ apply_filters( 'litespeed_media_iframe_lazy_parent_cls_excludes', $this->conf( Base::O_MEDIA_IFRAME_LAZY_PARENT_CLS_EXC ) ); -
litespeed_media_info
filter/** * WP Stateless compatibility #143 * https://github.com/litespeedtech/lscache_wp/issues/143 */ apply_filters( 'litespeed_media_info', [], $short_file_path, $post_id ); -
/** * Exclude list. */ apply_filters( 'litespeed_media_lazy_img_excludes', $this->conf( Base::O_MEDIA_LAZY_EXC ) ); -
/** * Exclude parent classes. */ apply_filters( 'litespeed_media_lazy_img_parent_cls_excludes', $this->conf( Base::O_MEDIA_LAZY_PARENT_CLS_EXC ) ); -
litespeed_purged
action/** * Fires when _add() extends the public purge list, before header delivery or * queue storage. */ do_action( 'litespeed_purged', $tags, $purge2 ); -
/** * Filters the generated static-directory .htaccess content. */ apply_filters( 'litespeed_static_dir_htaccess', $content ); -
/** * Allow bypassing pending comment check for comment plugins. */ apply_filters( 'litespeed_vary_check_commenter_pending', true ); -
nonce_user_logged_out
filter/** * This filter is documented in wp-includes/pluggable.php */ apply_filters( 'nonce_user_logged_out', $uid, $action ); -
rest_url_prefix
filter/** * Bypass post/page link setting */ apply_filters( 'rest_url_prefix', 'wp-json' ); -
litespeed_debug
actiondo_action( 'litespeed_debug', '[API] Disabled_all due to ' . $reason ); -
litespeed_purge
actiondo_action( 'litespeed_purge', self::CACHETAG_GALLERIES . $image->galleryid ); -
litespeed_conf
filterapply_filters( 'litespeed_conf', $id ); -
do_action( 'litespeed_control_set_nocache', 'bbpress nocache due to loggedin' ); -
litespeed_purge_post
actiondo_action( 'litespeed_purge_post', $ancestor ); -
litespeed_purge_all
actiondo_action( 'litespeed_purge_all', '3rd Autoptimize' ); -
litespeed_disable_all
actiondo_action( 'litespeed_disable_all', 'divi edit mode' ); -
apply_filters( 'litespeed_const_DONOTCACHEPAGE', DONOTCACHEPAGE ); -
litespeed_control_cacheable
filterapply_filters( 'litespeed_control_cacheable', false ); -
litespeed_esi_status
filterapply_filters( 'litespeed_esi_status', false ); -
litespeed_purge_widget
actiondo_action( 'litespeed_purge_widget', $replies_widget->id ); -
litespeed_realpath
filterapply_filters( 'litespeed_realpath', $file ); -
litespeed_tag_add
actiondo_action( 'litespeed_tag_add', $tag . $id ); -
litespeed_conf_append
actiondo_action( 'litespeed_conf_append', self::O_UPDATE_INTERVAL, false ); -
apply_filters( 'litespeed_crawler_disable_blocklist', false, $url ); -
litespeed_esi_url
filterapply_filters( 'litespeed_esi_url', 'storefront-cart-header', 'STOREFRONT_CART_HEADER' ); -
litespeed_internal_domains
filterapply_filters( 'litespeed_internal_domains', [] ); -
litespeed_is_mobile
filterapply_filters( 'litespeed_is_mobile', false ); -
litespeed_media_del
actiondo_action( 'litespeed_media_del', $short_file_path, $post_id ); -
litespeed_media_rename
actiondo_action( 'litespeed_media_rename', $short_file_path, $short_file_path_new, $post_id ); -
litespeed_ucss_per_pagetype
filterapply_filters( 'litespeed_ucss_per_pagetype', false ); -
litespeed_ucss_url
filterapply_filters( 'litespeed_ucss_url', $request_url ); -
apply_filters( 'litespeed_url_file_expired_days', 20 ); -
litespeed_vary_cookies
filterapply_filters( 'litespeed_vary_cookies', array() ); -
nonce_life
filterapply_filters( 'nonce_life', DAY_IN_SECONDS, $action ); -
big_image_size_threshold
filterapply_filters( 'big_image_size_threshold', 2560, [], '', 0 ); -
comment_cookie_lifetime
filterapply_filters( 'comment_cookie_lifetime', 30000000 ); -
do_shortcode_tag
filterapply_filters( 'do_shortcode_tag', $output, $shortcode, $atts_ori, $matches ); -
apply_filters( "litespeed_{$this->_svc_id()}_priority", $is_front_page, $request_url ); -
litespeed_{$type}
filterapply_filters( "litespeed_{$type}", $css, $queue_k ); -
litespeed_3rd_aelia_cookies
filterapply_filters( 'litespeed_3rd_aelia_cookies', self::$_cookies ); -
litespeed_after_admin_init
actiondo_action( 'litespeed_after_admin_init' ); -
litespeed_api_purge_post
actiondo_action( 'litespeed_api_purge_post', $post_id ); -
litespeed_avatar_limit
filterapply_filters( 'litespeed_avatar_limit', 30 ); -
litespeed_backend_htaccess
filterapply_filters( 'litespeed_backend_htaccess', $this->backend_htaccess ); -
litespeed_backend_shortcut
actiondo_action( 'litespeed_backend_shortcut' ); -
litespeed_buffer_after
filterapply_filters( 'litespeed_buffer_after', $buffer ); -
litespeed_buffer_before
filterapply_filters( 'litespeed_buffer_before', $buffer ); -
litespeed_buffer_finalize
filterapply_filters( 'litespeed_buffer_finalize', $buffer ); -
litespeed_bypass_metabox
filterapply_filters( 'litespeed_bypass_metabox', false, $post_type ); -
litespeed_can_cdn
filterapply_filters( 'litespeed_can_cdn', $can ); -
litespeed_can_change_vary
filterapply_filters( 'litespeed_can_change_vary', true ); -
litespeed_can_optm
filterapply_filters( 'litespeed_can_optm', $can ); -
litespeed_ccss_url
filterapply_filters( 'litespeed_ccss_url', $request_url ); -
litespeed_ccss_whitelist
filterapply_filters( 'litespeed_ccss_whitelist', $this->conf( self::O_OPTM_CCSS_SELECTOR_WHITELIST ) ); -
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' ], ] ); -
litespeed_clean_wrapper_end
filterapply_filters( 'litespeed_clean_wrapper_end', '' ); -
litespeed_comment
filterapply_filters( 'litespeed_comment', $running_info_showing ); -
litespeed_conf_multi_switch
actiondo_action( 'litespeed_conf_multi_switch', self::O_UPDATE_INTERVAL, 3 ); -
litespeed_control_finalize
actiondo_action( 'litespeed_control_finalize', defined( 'LSCACHE_IS_ESI' ) ? LSCACHE_IS_ESI : false ); -
do_action( 'litespeed_control_set_private', 'yith wishlist' ); -
litespeed_control_set_ttl
actiondo_action( 'litespeed_control_set_ttl', $ttl, "WooCommerce set scheduled TTL to $ttl" ); -
litespeed_control_ttl
filterapply_filters( 'litespeed_control_ttl', 0 ); -
litespeed_crawler_cookies
filterapply_filters( 'litespeed_crawler_cookies', $this->conf( Base::O_CRAWLER_COOKIES ) ); -
do_action( 'litespeed_crawler_cookies_after' ); -
litespeed_crawler_webp
filterapply_filters( 'litespeed_crawler_webp', false ); -
apply_filters( 'litespeed_debug_show_max_lines', 1000 ); -
litespeed_delay_purge
filterapply_filters( 'litespeed_delay_purge', false ); -
litespeed_esi_combine
actiondo_action( 'litespeed_esi_combine', 'yith_wcwl_add' ); -
litespeed_esi_control
filterapply_filters( 'litespeed_esi_control', $control, $block_id ); -
apply_filters( "litespeed_esi_inline-{$esi_id}", array(), $esi_param ); -
do_action( "litespeed_esi_load-{$block_id}", $params ); -
do_action( "litespeed_esi_load-{LSCACHE_IS_ESI}", $params ); -
litespeed_esi_nonces
filterapply_filters( 'litespeed_esi_nonces', $nonces ); -
litespeed_esi_params
filterapply_filters( 'litespeed_esi_params', $params, $block_id ); -
do_action( "litespeed_esi_shortcode-{$atts[0]}" ); -
apply_filters( 'litespeed_font_optimize_value', 'swap' ); -
litespeed_frontend_htaccess
filterapply_filters( 'litespeed_frontend_htaccess', $this->frontend_htaccess ); -
litespeed_frontend_shortcut
actiondo_action( 'litespeed_frontend_shortcut' ); -
litespeed_html_min
filterapply_filters( 'litespeed_html_min', true ); -
apply_filters( 'litespeed_iframe_lazyload_exc', false, $attrs['src'] ); -
apply_filters( 'litespeed_imgoptm_new_req_interval', 3600 ); -
apply_filters( 'litespeed_imgoptm_sizes_skipped', $this->conf( Base::O_IMG_OPTM_SIZES_SKIPPED ) ); -
litespeed_initing
actiondo_action( 'litespeed_initing' ); -
litespeed_is_editor
filterapply_filters( 'litespeed_is_editor', $res ); -
litespeed_is_json
filterapply_filters( 'litespeed_is_json', false ); -
litespeed_lazyload_threshold
filterapply_filters( 'litespeed_lazyload_threshold', 300 ); -
litespeed_load_thirdparty
actiondo_action( 'litespeed_load_thirdparty' ); -
apply_filters( 'litespeed_media_add_missing_sizes', true ); -
litespeed_media_check_webp
filterapply_filters( 'litespeed_media_check_webp', Utility::is_internal_file( $url, $this->_sys_format ), $url ); -
apply_filters( 'litespeed_media_iframe_lazy_cls_excludes', $this->conf( Base::O_MEDIA_IFRAME_LAZY_CLS_EXC ) ); -
apply_filters( 'litespeed_media_ignore_remote_missing_sizes', true ); -
apply_filters( 'litespeed_media_lazy_img_cls_excludes', $this->conf( Base::O_MEDIA_LAZY_CLS_EXC ) ); -
litespeed_media_row
actiondo_action( 'litespeed_media_row', $post_id ); -
litespeed_media_row_lqip
actiondo_action( 'litespeed_media_row_lqip', $post_id ); -
litespeed_next_gen_format
filterapply_filters( 'litespeed_next_gen_format', $this->_format ); -
litespeed_optimax
filterapply_filters( 'litespeed_optimax', $content, $queue_k ); -
litespeed_optimax_exc
filterapply_filters( 'litespeed_optimax_exc', $this->conf( self::O_OPTIMAX_EXC ) ); -
apply_filters( 'litespeed_optimax_per_pagetype', false ); -
litespeed_optimax_url
filterapply_filters( 'litespeed_optimax_url', $request_url ); -
apply_filters( 'litespeed_optimize_css_excludes', $this->conf(self::O_OPTM_CSS_EXC) ); -
apply_filters( 'litespeed_optimize_js_excludes', $this->conf(self::O_OPTM_JS_EXC) ); -
apply_filters( 'litespeed_optimize_ucss_file_exc_inline', $this->conf(self::O_OPTM_UCSS_FILE_EXC_INLINE) ); -
litespeed_optm
actiondo_action( 'litespeed_optm' ); -
apply_filters( 'litespeed_optm_css_comb_ext_inl', true ); -
apply_filters( 'litespeed_optm_css_to_be_removed', [] ); -
litespeed_optm_cssjs
filterapply_filters( 'litespeed_optm_cssjs', $content, $file_type, $src ); -
litespeed_optm_gm_js_exc
filterapply_filters( 'litespeed_optm_gm_js_exc', $this->conf(self::O_OPTM_GM_JS_EXC) ); -
apply_filters( 'litespeed_optm_html_after_head', false ); -
litespeed_optm_html_foot
filterapply_filters( 'litespeed_optm_html_foot', $this->html_foot ); -
litespeed_optm_html_head
filterapply_filters( 'litespeed_optm_html_head', $this->html_head ); -
apply_filters( 'litespeed_optm_html_head_early', $this->html_head_early ); -
apply_filters( 'litespeed_optm_js_comb_ext_inl', true ); -
litespeed_optm_js_defer_exc
filterapply_filters( 'litespeed_optm_js_defer_exc', $this->conf(self::O_OPTM_JS_DEFER_EXC) ); -
litespeed_optm_uri_exc
filterapply_filters( 'litespeed_optm_uri_exc', $this->conf(self::O_OPTM_EXC) ); -
litespeed_purge_esi
actiondo_action( 'litespeed_purge_esi', 'yith_wcwl_add' ); -
litespeed_purge_finalize
actiondo_action( 'litespeed_purge_finalize' ); -
litespeed_purge_post_events
filterapply_filters( 'litespeed_purge_post_events', [ 'delete_post', 'wp_trash_post', 'wp_update_comment_count', ] ); -
apply_filters( 'litespeed_purge_post_skip_non_viewable', true, $post_id ); -
litespeed_purge_posttype
actiondo_action( 'litespeed_purge_posttype', bbp_get_forum_post_type() ); -
litespeed_purge_private_all
actiondo_action( 'litespeed_purge_private_all' ); -
litespeed_purge_private_esi
actiondo_action( 'litespeed_purge_private_esi', 'storefront-cart-header' ); -
litespeed_purge_tags
filterapply_filters( 'litespeed_purge_tags', $purge_tags, $is_private ); -
litespeed_purge_ucss
actiondo_action( 'litespeed_purge_ucss', $url_tag ); -
litespeed_purged_all
actiondo_action( 'litespeed_purged_all' ); -
litespeed_purged_all_avatar
actiondo_action( 'litespeed_purged_all_avatar' ); -
litespeed_purged_all_ccss
actiondo_action( 'litespeed_purged_all_ccss' ); -
litespeed_purged_all_cssjs
actiondo_action( 'litespeed_purged_all_cssjs' ); -
do_action( 'litespeed_purged_all_localres' ); -
litespeed_purged_all_lqip
actiondo_action( 'litespeed_purged_all_lqip' ); -
litespeed_purged_all_lscache
actiondo_action( 'litespeed_purged_all_lscache' ); -
litespeed_purged_all_object
actiondo_action( 'litespeed_purged_all_object' ); -
litespeed_purged_all_opcache
actiondo_action( 'litespeed_purged_all_opcache' ); -
litespeed_purged_all_optimax
actiondo_action( 'litespeed_purged_all_optimax' ); -
litespeed_purged_all_ucss
actiondo_action( 'litespeed_purged_all_ucss' ); -
litespeed_purged_all_vpi
actiondo_action( 'litespeed_purged_all_vpi' ); -
litespeed_purged_cat
actiondo_action( 'litespeed_purged_cat', $value ); -
do_action( 'litespeed_purged_comment_widget', $recent_comments->id ); -
litespeed_purged_esi
actiondo_action( 'litespeed_purged_esi', $tag ); -
litespeed_purged_feeds
actiondo_action( 'litespeed_purged_feeds' ); -
litespeed_purged_front
actiondo_action( 'litespeed_purged_front', $ref ); -
litespeed_purged_frontpage
actiondo_action( 'litespeed_purged_frontpage' ); -
litespeed_purged_link
actiondo_action( 'litespeed_purged_link', $url ); -
litespeed_purged_on_logout
actiondo_action( 'litespeed_purged_on_logout' ); -
litespeed_purged_pages
actiondo_action( 'litespeed_purged_pages' ); -
litespeed_purged_post
actiondo_action( 'litespeed_purged_post', $pid ); -
litespeed_purged_posttype
actiondo_action( 'litespeed_purged_posttype', $post_type ); -
litespeed_purged_single
actiondo_action( 'litespeed_purged_single' ); -
litespeed_purged_tag
actiondo_action( 'litespeed_purged_tag', $val ); -
litespeed_purged_widget
actiondo_action( 'litespeed_purged_widget', $widget_id ); -
litespeed_setting_enroll
actiondo_action( 'litespeed_setting_enroll', $setting_id ); -
litespeed_settings_content
actiondo_action( 'litespeed_settings_content', 'cache' ); -
litespeed_settings_tab
actiondo_action( 'litespeed_settings_tab', 'cache' ); -
litespeed_tag_add_post
actiondo_action( 'litespeed_tag_add_post', $related ); -
litespeed_tag_finalize
actiondo_action( 'litespeed_tag_finalize' ); -
litespeed_tpl_normal
actiondo_action( 'litespeed_tpl_normal' ); -
litespeed_ucss_exc
filterapply_filters( 'litespeed_ucss_exc', $this->conf( self::O_OPTM_UCSS_EXC ) ); -
litespeed_ucss_whitelist
filterapply_filters( 'litespeed_ucss_whitelist', $this->conf( self::O_OPTM_UCSS_SELECTOR_WHITELIST ) ); -
litespeed_update_confs
actiondo_action( 'litespeed_update_confs', $the_matrix ); -
litespeed_vary_ajax_force
actiondo_action( 'litespeed_vary_ajax_force' ); -
litespeed_vary_curr_cookies
filterapply_filters( 'litespeed_vary_curr_cookies', $cookies ); -
litespeed_vary_no
actiondo_action( 'litespeed_vary_no' ); -
litespeed_vpi_should_queue
filterapply_filters( 'litespeed_vpi_should_queue', true, $request_url ); -
litespeed_vpi_url
filterapply_filters( 'litespeed_vpi_url', $request_url ); -
apply_filters( 'litespeed_widget_default_options', $options, $widget ); -
litespeed_wpconfig_readonly
filterapply_filters( 'litespeed_wpconfig_readonly', false ); -
pre_do_shortcode_tag
filterapply_filters( 'pre_do_shortcode_tag', false, $shortcode, $atts_ori, $matches ); -
wpml_active_languages
filterapply_filters( 'wpml_active_languages', null ); -
wpml_element_trid
filterapply_filters( 'wpml_element_trid', false, $wpml_purge_id, $type ); -
wpml_element_type
filterapply_filters( 'wpml_element_type', get_post_type( $wpml_purge_id ) ); -
apply_filters( 'wpml_get_element_translations', [], $trid, $type ); -
wpml_setting
filterapply_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: