{"id":14459,"date":"2025-08-14T05:06:33","date_gmt":"2025-08-14T05:06:33","guid":{"rendered":"https:\/\/www.kadencewp.com\/help-center\/?post_type=docs&#038;p=14459"},"modified":"2026-04-22T14:41:56","modified_gmt":"2026-04-22T14:41:56","password":"","slug":"display-kadence-hook-elements","status":"publish","type":"docs","link":"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/display-kadence-hook-elements\/","title":{"rendered":"Programmatically Display Kadence Hook Elements"},"content":{"rendered":"\n<p><a href=\"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/what-are-kadence-hooked-elements\/\" target=\"_blank\" rel=\"noreferrer noopener\">Kadence Hooked Elements<\/a> give you full control over your site\u2019s layout and content by allowing you to insert elements, whether simple content sections or complete templates, into specific areas via theme hooks. You can design reusable layouts with dynamic content and dictate exactly when and where they appear. Normally, visibility is managed through the Element <strong>Display Settings<\/strong> in the editor, but you also have the option to programmatically override these settings for greater flexibility.<\/p>\n\n\n\n<p>Sometimes, you need more dynamic control, such as showing an element only for subcategories of a specific blog category, based on a URL variable, or within certain dates. This is where the <strong>kadence_element_display<\/strong> filter becomes useful.<\/p>\n\n\n\n<p><strong>Important<\/strong>: In the Element settings, set <strong>Display Settings<\/strong> to <strong>None<\/strong>. This ensures there is no conflict between the code logic and the editor rules.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"442\" height=\"1024\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/Add-New-Element-\u2039-SITE-TITLE-\u2014-WordPress-2025-08-14-at-12.50.31-PM-442x1024.jpg\" alt=\"\" class=\"wp-image-14461\" style=\"width:300px\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/Add-New-Element-\u2039-SITE-TITLE-\u2014-WordPress-2025-08-14-at-12.50.31-PM-442x1024.jpg 442w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/Add-New-Element-\u2039-SITE-TITLE-\u2014-WordPress-2025-08-14-at-12.50.31-PM-129x300.jpg 129w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/Add-New-Element-\u2039-SITE-TITLE-\u2014-WordPress-2025-08-14-at-12.50.31-PM-221x512.jpg 221w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/Add-New-Element-\u2039-SITE-TITLE-\u2014-WordPress-2025-08-14-at-12.50.31-PM.jpg 684w\" sizes=\"auto, (max-width: 442px) 100vw, 442px\" \/><\/figure>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59, .wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59[data-kb-block=\"kb-adv-heading14459_e88b66-59\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59[data-kb-block=\"kb-adv-heading14459_e88b66-59\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_e88b66-59[data-kb-block=\"kb-adv-heading14459_e88b66-59\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading14459_e88b66-59 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_e88b66-59\">What the kadence_element_display Filter Does<\/h2>\n\n\n\n<p>The <strong>kadence_element_display<\/strong> filter runs every time Kadence checks whether to show a Hooked Element.<\/p>\n\n\n\n<p>You can use it to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Return <strong>true<\/strong> to show the element<\/li>\n\n\n\n<li>Return <strong>false<\/strong> to hide the element<\/li>\n\n\n\n<li>Return <strong>$display<\/strong> to keep the original decision from the editor<\/li>\n<\/ul>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59, .wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59[data-kb-block=\"kb-adv-heading14459_8ba943-59\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59[data-kb-block=\"kb-adv-heading14459_8ba943-59\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_8ba943-59[data-kb-block=\"kb-adv-heading14459_8ba943-59\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading14459_8ba943-59 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_8ba943-59\"><strong>Filter structure:<\/strong><\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">apply_filters( 'kadence_element_display', bool $display, WP_Post $element, array $meta )<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>$display<\/strong> \u2192 current decision from the editor<\/li>\n\n\n\n<li><strong>$element<\/strong> \u2192 the Hooked Element post object<\/li>\n\n\n\n<li><strong>$meta<\/strong> \u2192 element meta data<\/li>\n<\/ul>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e, .wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e[data-kb-block=\"kb-adv-heading14459_59c217-1e\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e[data-kb-block=\"kb-adv-heading14459_59c217-1e\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_59c217-1e[data-kb-block=\"kb-adv-heading14459_59c217-1e\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading14459_59c217-1e wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_59c217-1e\">Examples:<\/h2>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9, .wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9[data-kb-block=\"kb-adv-heading14459_3db28c-b9\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9[data-kb-block=\"kb-adv-heading14459_3db28c-b9\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_3db28c-b9[data-kb-block=\"kb-adv-heading14459_3db28c-b9\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading14459_3db28c-b9 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_3db28c-b9\">Show an Element for All Subcategories of a Parent Blog Category<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_element_display', function( $display, $element, $meta ) {\n\n\t$target_element_id = 288297; \/\/ Your Hooked Element ID\n\t$parent_cat_id     = 8890;   \/\/ Parent category ID\n\n\tif ( $element-&gt;ID !== $target_element_id ) {\n\t\treturn $display;\n\t}\n\n\tstatic $child_ids = null;\n\tif ( $child_ids === null ) {\n\t\t$child_ids = get_term_children( (int) $parent_cat_id, 'category' );\n\t\tif ( is_wp_error( $child_ids ) ) {\n\t\t\t$child_ids = [];\n\t\t}\n\t}\n\n\tif ( empty( $child_ids ) ) {\n\t\treturn false;\n\t}\n\n\tif ( is_category() ) {\n\t\t$current_cat_id = get_queried_object_id();\n\t\tif ( in_array( $current_cat_id, $child_ids, true ) ) {\n\t\t\treturn true;\n\t\t}\n\t}\n\n\treturn false;\n\n}, 20, 3 );<\/code><\/pre>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64, .wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64[data-kb-block=\"kb-adv-heading14459_a84f67-64\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64[data-kb-block=\"kb-adv-heading14459_a84f67-64\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_a84f67-64[data-kb-block=\"kb-adv-heading14459_a84f67-64\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading14459_a84f67-64 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_a84f67-64\">Show Element Based on a URL Variable<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_element_display', function( $display, $element, $meta ) {\n\n\tif ( $element-&gt;ID !== 12345 ) {\n\t\treturn $display;\n\t}\n\n\tif ( isset( $_GET['promo'] ) &amp;&amp; $_GET['promo'] === 'yes' ) {\n\t\treturn true;\n\t}\n\n\treturn false;\n\n}, 20, 3 );<\/code><\/pre>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff, .wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff[data-kb-block=\"kb-adv-heading14459_ea9d05-ff\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff[data-kb-block=\"kb-adv-heading14459_ea9d05-ff\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_ea9d05-ff[data-kb-block=\"kb-adv-heading14459_ea9d05-ff\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading14459_ea9d05-ff wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_ea9d05-ff\">Show Element Only on Specific Dates<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_element_display', function( $display, $element, $meta ) {\n\n\tif ( $element-&gt;ID !== 67890 ) {\n\t\treturn $display;\n\t}\n\n\t$today = date( 'Y-m-d' );\n\n\tif ( $today &gt;= '2025-08-01' &amp;&amp; $today &lt;= '2025-08-15' ) {\n\t\treturn true;\n\t}\n\n\treturn false;\n\n}, 20, 3 );<\/code><\/pre>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c, .wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c[data-kb-block=\"kb-adv-heading14459_11d66d-4c\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c[data-kb-block=\"kb-adv-heading14459_11d66d-4c\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_11d66d-4c[data-kb-block=\"kb-adv-heading14459_11d66d-4c\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading14459_11d66d-4c wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_11d66d-4c\">How to Find Your Element ID<\/h2>\n\n\n\n<p>You can find the Element ID\u00a0by navigating to\u00a0<strong>Dashboard -&gt; Appearance -&gt; Kadence -&gt; Elements<\/strong>\u00a0and checking the element details.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"423\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-1024x423.jpg\" alt=\"\" class=\"wp-image-14463\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-1024x423.jpg 1024w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-300x124.jpg 300w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-768x317.jpg 768w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-1536x635.jpg 1536w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-2048x846.jpg 2048w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/08\/ElementID-scaled.jpg-2560\u00d71053-2025-08-14-at-1.00.16-PM-360x149.jpg 360w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b, .wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b[data-kb-block=\"kb-adv-heading14459_fd0437-4b\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b[data-kb-block=\"kb-adv-heading14459_fd0437-4b\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading14459_fd0437-4b[data-kb-block=\"kb-adv-heading14459_fd0437-4b\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading14459_fd0437-4b wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading14459_fd0437-4b\">Where to Put the Code<\/h2>\n\n\n\n<p>Code snippets can be added to the\u00a0<code>functions.php<\/code>\u00a0file of a\u00a0<a href=\"https:\/\/www.kadencewp.com\/blog\/child-themes\/\" target=\"_blank\" rel=\"noreferrer noopener\">child theme\u00a0<\/a>or through a plugin like Code Snippets. You can read documentation on using the Code Snippets Plugin\u00a0<a href=\"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/how-to-add-a-custom-filter-or-function-with-code-snippets\/\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Kadence Hooked Elements give you full control over your site\u2019s layout and content by allowing you to insert elements, whether simple content sections or complete templates, into specific areas via theme hooks. You can design reusable layouts with dynamic content and dictate exactly when and where they appear. Normally, visibility is managed through the Element&#8230;<\/p>\n","protected":false},"author":116562,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"doc_category":[446],"doc_tag":[],"knowledge_base":[6],"class_list":["post-14459","docs","type-docs","status-publish","hentry","doc_category-hooked-element-guides","knowledge_base-kadence-theme"],"year_month":"2026-04","word_count":460,"total_views":"2161","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Bonn","author_link":"https:\/\/www.kadencewp.com\/help-center\/author\/bonnjoelelimanco\/"},"doc_category_info":[{"term_name":"Hooked Element Guides","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/hooked-element-guides\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"Kadence Theme","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/","term_slug":"kadence-theme"}],"knowledge_base_slug":["kadence-theme"],"taxonomy_info":{"doc_category":[{"value":446,"label":"Hooked Element Guides"}],"knowledge_base":[{"value":6,"label":"Kadence Theme"}]},"featured_image_src_large":false,"comment_info":0,"_links":{"self":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/14459","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/users\/116562"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/comments?post=14459"}],"version-history":[{"count":1,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/14459\/revisions"}],"predecessor-version":[{"id":14464,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/14459\/revisions\/14464"}],"wp:attachment":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/media?parent=14459"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_category?post=14459"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_tag?post=14459"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/knowledge_base?post=14459"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}