{"id":1038,"date":"2020-11-13T16:55:02","date_gmt":"2020-11-13T23:55:02","guid":{"rendered":"https:\/\/kadence-theme.com\/?post_type=knowledgebase&#038;p=1038"},"modified":"2026-04-22T16:02:32","modified_gmt":"2026-04-22T16:02:32","password":"","slug":"use-element-hooks","status":"publish","type":"docs","link":"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/use-element-hooks\/","title":{"rendered":"How to use Element Hooks"},"content":{"rendered":"\n<p>One of the features that&nbsp;<a href=\"https:\/\/www.kadencewp.com\/pricing\/\">Kadence Theme Kit Pro<\/a>&nbsp;adds to the&nbsp;Kadence&nbsp;theme is called&nbsp;<strong>Hooked Elements<\/strong>&nbsp;(or Element Hooks) which provides an interface to build an element using the WordPress Gutenberg editor (or custom code) and hook it to one of the several locations on your site&#8217;s pages so it appears exactly where and when you want.<\/p>\n\n\n\n<p>In short, element hooks allow you to add content in different areas of a page, with unlimited customization options.<\/p>\n\n\n\n<p>One possible use case would be for adding a notification bar above the site header for announcements that automatically expire after a set date for seasonal banners.<\/p>\n\n\n\n<p>Here&#8217;s a detailed walkthrough on how an affiliate disclosure text can be automatically added above the entry content for all posts that have a specific tag:<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1<\/h2>\n\n\n\n<p>Install and activate the Kadence Theme Kit Pro plugin. It is included in&nbsp;<a href=\"https:\/\/www.kadencewp.com\/pricing\/\">Kadence Plans<\/a> and can also be purchased individually.<\/p>\n\n\n\n<p>Enter your license key and email at Appearance &gt; Kadence if you have not already.<\/p>\n\n\n\n<p>Enable&nbsp;<code><strong>Hooked Elements<\/strong><\/code>.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-pro-addons-1024x537.png\" alt=\"Kadence Pro - Hooked Elements\" class=\"wp-image-265\" \/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Step 2<\/h2>\n\n\n\n<p>Click on the Customize link to be taken to the Elements page. This page can be reached via Appearance &gt; Kadence &gt; Elements.<\/p>\n\n\n\n<p>Click&nbsp;<strong>Add New<\/strong>&nbsp;to add a new element.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-elements-add-new-1024x218.png\" alt=\"Adding a new element in Kadence\" class=\"wp-image-269\" \/><\/figure><\/div>\n\n\n<p>Here you are presented with four options.<\/p>\n\n\n\n<p><strong>CONTENT SECTION<\/strong>&nbsp;lets you build the element using the Customizer blocks.<\/p>\n\n\n\n<p><strong>FIXED SECTION<\/strong> allows you to create content that is fixed to your site.<\/p>\n\n\n\n<p><strong>TEMPLATE<\/strong> lets you make templates that replace sections like a sidebar or page.<\/p>\n\n\n\n<p><strong>HTML EDITOR<\/strong> lets you build your element using HTML code.<\/p>\n\n\n\n<p>In this example, we shall go with the CONTENT SECTION.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"504\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup-1024x504.jpeg\" alt=\"Kadence Element Setup\" class=\"wp-image-5759\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup-1024x504.jpeg 1024w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup-300x148.jpeg 300w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup-768x378.jpeg 768w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup-1536x756.jpeg 1536w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2022\/07\/Element-Setup.jpeg 1915w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure><\/div>\n\n\n<p>Enter a title and the content for your element.<\/p>\n\n\n\n<p>Click on&nbsp;the Element Settings&nbsp;icon next to the gear icon near the top right.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-elements-element-settings-1024x231.png\" alt=\"Kadence Element Settings icon in the Gutenberg editor\" class=\"wp-image-271\" \/><\/figure><\/div>\n\n\n<p>Configure the element&#8217;s behavior by selecting where it should appear.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-hooked-elements-configuration.png\" alt=\"Configuring an element's settings\" class=\"wp-image-272\" style=\"width:287px;height:718px\" \/><\/figure><\/div>\n\n\n<p>In this example, we have set the element to be added before entry content on all single posts that are tagged&nbsp;<code>Kadence<\/code>.<\/p>\n\n\n\n<p>The screenshot below shows all the options in the&nbsp;<strong>Display Settings<\/strong>&#8216; Show On dropdown:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-hooked-elements-show-on-options.png\" alt=\"Element Hooks Display Settings options\" class=\"wp-image-275\" style=\"width:279px;height:816px\" \/><figcaption class=\"wp-element-caption\">The last \u201cSingle Simple URLs\u201d is a Custom Post Type in our demo site<\/figcaption><\/figure><\/div>\n\n\n<p>The screenshot below shows all the options in the&nbsp;<strong>Placement<\/strong>&nbsp;dropdown:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-hooked-elements-placement-options.png\" alt=\"Kadence element hook placement options\" class=\"wp-image-273\" style=\"width:262px;height:1366px\" \/><\/figure><\/div>\n\n<style>.kb-row-layout-id1038_b2e5cf-42 > .kt-row-column-wrap{align-content:start;}:where(.kb-row-layout-id1038_b2e5cf-42 > .kt-row-column-wrap) > .wp-block-kadence-column{justify-content:start;}.kb-row-layout-id1038_b2e5cf-42 > .kt-row-column-wrap{column-gap:var(--global-kb-gap-md, 2rem);row-gap:var(--global-kb-gap-md, 2rem);padding-top:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-sm, 1.5rem);grid-template-columns:minmax(0, 1fr);}.kb-row-layout-id1038_b2e5cf-42 > .kt-row-layout-overlay{opacity:0.30;}@media all and (max-width: 1024px){.kb-row-layout-id1038_b2e5cf-42 > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}@media all and (max-width: 767px){.kb-row-layout-id1038_b2e5cf-42 > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}<\/style><div class=\"kb-row-layout-wrap kb-row-layout-id1038_b2e5cf-42 alignnone has-theme-palette7-background-color kt-row-has-bg wp-block-kadence-rowlayout\" id=\"what-is-a-custom-hook\"><div class=\"kt-row-column-wrap kt-has-1-columns kt-row-layout-equal kt-tab-layout-inherit kt-mobile-layout-row kt-row-valign-top\">\n<style>.kadence-column1038_c08bc4-99 > .kt-inside-inner-col,.kadence-column1038_c08bc4-99 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column1038_c08bc4-99 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column1038_c08bc4-99 > .kt-inside-inner-col{flex-direction:column;}.kadence-column1038_c08bc4-99 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column1038_c08bc4-99 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column1038_c08bc4-99{position:relative;}@media all and (max-width: 1024px){.kadence-column1038_c08bc4-99 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column1038_c08bc4-99 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column1038_c08bc4-99\"><div class=\"kt-inside-inner-col\"><style>.wp-block-kadence-advancedheading.kt-adv-heading1038_4a8d8e-10, .wp-block-kadence-advancedheading.kt-adv-heading1038_4a8d8e-10[data-kb-block=\"kb-adv-heading1038_4a8d8e-10\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading1038_4a8d8e-10 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading1038_4a8d8e-10[data-kb-block=\"kb-adv-heading1038_4a8d8e-10\"] 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-heading1038_4a8d8e-10 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading1038_4a8d8e-10[data-kb-block=\"kb-adv-heading1038_4a8d8e-10\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading1038_4a8d8e-10 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading1038_4a8d8e-10\">What is a Custom Hook?<\/h3>\n\n\n\n<p>The dropdown list for <strong>element hook placement<\/strong> includes the most commonly used hooks. However, it is not possible to include every available hook from the theme and plugins.<\/p>\n\n\n\n<p>That is why there is an option to <strong>specify a custom hook<\/strong>. You can use this if you are familiar with an existing hook in your theme or plugin that you would like to target. Please note that:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The hook must already exist in the theme or plugin. This feature only lets you hook into existing hooks, it does not create new ones.<\/li>\n\n\n\n<li>Using custom hooks requires a <strong>deeper understanding of the theme or plugin code<\/strong>, since you will need to know the exact hook name and where it is applied.<\/li>\n<\/ul>\n<\/div><\/div>\n\n<\/div><\/div>\n\n\n<p><\/p>\n\n\n\n<p>An element with a higher priority hooked to the same location as another will appear below or after the one with lower priority in the HTML output.<\/p>\n\n\n\n<pre class=\"wp-block-verse\">Note: A specific tag or category will appear under the \"Select Posts By:\" only if there is at least one published post having that tag\/category.<\/pre>\n\n\n\n<p><strong>Publish<\/strong>&nbsp;your changes.<\/p>\n\n\n\n<p>Here&#8217;s the result:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-hooked-elements-final-result-1024x576.png\" alt=\"\" class=\"wp-image-274\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">User Settings<\/h3>\n\n\n\n<p>User Settings section enables you to specify whether the element should be shown to all users, only the logged-out, the logged-in, or users having a specific role.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-element-hook-user-settings.png\" alt=\"\" class=\"wp-image-278\" style=\"width:280px;height:452px\" \/><\/figure><\/div>\n\n\n<h3 class=\"wp-block-heading\">Expires Settings<\/h3>\n\n\n\n<p>Expires Settings section enables you to specify whether the element should automatically be removed (not shown) at a specified date and time.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" src=\"https:\/\/www.kadencewp.com\/kadence-theme\/wp-content\/uploads\/sites\/10\/2020\/09\/kadence-element-hook-expires-settings.png\" alt=\"Expires Settings section when adding an element in Kadence\" class=\"wp-image-276\" style=\"width:216px;height:390px\" \/><\/figure><\/div>\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading1038_6aae3f-2c, .wp-block-kadence-advancedheading.kt-adv-heading1038_6aae3f-2c[data-kb-block=\"kb-adv-heading1038_6aae3f-2c\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading1038_6aae3f-2c mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading1038_6aae3f-2c[data-kb-block=\"kb-adv-heading1038_6aae3f-2c\"] 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-heading1038_6aae3f-2c img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading1038_6aae3f-2c[data-kb-block=\"kb-adv-heading1038_6aae3f-2c\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 id=\"viewing-elements-on-a-page\" class=\"kt-adv-heading1038_6aae3f-2c wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading1038_6aae3f-2c\">Viewing Elements on a Page<\/h3>\n\n\n\n<p>When using the <strong><em>Admin Toolbar<\/em><\/strong>, you can view the current number of elements on a specific page. This makes it easier to track where Elements are being used.<br><br>Hover over the element count to directly edit any of the listed elements on the page. Just click on the element you wish to edit, and it will open up within the element editor.<\/p>\n\n\n<style>.kb-image1038_d18daf-a1 .kb-image-has-overlay:after{opacity:0.3;}<\/style>\n<figure class=\"wp-block-kadence-image kb-image1038_d18daf-a1 size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"2054\" height=\"1038\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2020\/11\/Elements-Tracking.gif\" alt=\"Elements Tracking\" class=\"kb-img wp-image-13375\" \/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>One of the features that&nbsp;Kadence Theme Kit Pro&nbsp;adds to the&nbsp;Kadence&nbsp;theme is called&nbsp;Hooked Elements&nbsp;(or Element Hooks) which provides an interface to build an element using the WordPress Gutenberg editor (or custom code) and hook it to one of the several locations on your site&#8217;s pages so it appears exactly where and when you want. In short,&#8230;<\/p>\n","protected":false},"author":1265,"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":[408],"doc_tag":[],"knowledge_base":[6],"class_list":["post-1038","docs","type-docs","status-publish","hentry","doc_category-theme-pro","knowledge_base-kadence-theme"],"year_month":"2026-05","word_count":683,"total_views":"15617","reactions":{"happy":"1","normal":"0","sad":"0"},"author_info":{"display_name":"Ben Ritner","author_link":"https:\/\/www.kadencewp.com\/help-center\/author\/britner\/"},"doc_category_info":[{"term_name":"Theme Kit Pro","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/theme-pro\/"}],"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":408,"label":"Theme Kit Pro"}],"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\/1038","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\/1265"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/comments?post=1038"}],"version-history":[{"count":9,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/1038\/revisions"}],"predecessor-version":[{"id":14702,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/1038\/revisions\/14702"}],"wp:attachment":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/media?parent=1038"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_category?post=1038"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_tag?post=1038"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/knowledge_base?post=1038"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}