{"id":6187,"date":"2022-10-12T14:26:05","date_gmt":"2022-10-12T11:26:05","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=6187"},"modified":"2026-10-08T11:09:15","modified_gmt":"2026-10-08T08:09:15","slug":"search","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/header-elements\/search\/","title":{"rendered":"Search"},"content":{"rendered":"\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6ada00595e89c&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6ada00595e89c\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2022\/10\/Screenshot-2022-10-12-at-14.49.50.png\" alt=\"Search element displayed inside a Blocksy header\" class=\"wp-image-6190\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">The Search element in action.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>Search<\/strong> element gives visitors quick access to your website&#8217;s search functionality directly from the header. Selecting the element opens a search overlay where visitors can enter their query and, when enabled, see matching results as they type.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Searches can include standard WordPress content such as posts and pages, WooCommerce products, and compatible Custom Post Types registered by plugins.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To use it, open the <strong>Customiser \u2192 Header<\/strong>, drag the <strong>Search<\/strong> element into the desired header row or supported area, and select it to configure its appearance and search behaviour.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">Granular Controls<\/h2>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-995f960e wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:33.33%\">\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6ada005960641&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6ada005960641\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"2820\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2022\/10\/Screenshot-2026-10-08-at-11.06.56.png\" alt=\"\" class=\"wp-image-15275\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Search element configuration options.<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:66.66%\">\n<h3 class=\"wp-block-heading\">Icon Controls<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Choose the icon used to represent the Search element in the header. Blocksy provides built-in search icons, while Blocksy Pro also lets you use a custom SVG icon.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>Icon Size<\/strong> control lets you adjust its dimensions independently across the available responsive device views.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Icon Visibility<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Choose whether the search icon itself is displayed on <strong>desktop<\/strong>, <strong>tablet<\/strong> and <strong>mobile<\/strong> devices. This can be useful when you want to rely primarily on the element&#8217;s text label in a particular header layout.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Label Visibility<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Control whether the Search element&#8217;s text label is displayed on <strong>desktop<\/strong>, <strong>tablet<\/strong> and <strong>mobile<\/strong> devices independently. This lets you combine an icon and descriptive label on larger screens while using a more compact presentation where space is limited.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Search Results<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">These settings control the search overlay and the results presented while visitors enter their query.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Placeholder Text<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Customise the placeholder displayed inside the search field before the visitor starts typing. This can be used to provide a short instruction or indicate what kind of content can be searched.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Live Results<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Enable <strong>Live Results<\/strong> to display matching content dynamically while the visitor types their search query. When disabled, visitors can still submit the search normally and continue to the standard search results page.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Live Results Images<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Choose whether featured images or product thumbnails are displayed alongside entries in the live results interface. Disabling images creates a more compact, text-focused results list.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Live Results Product Price<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">When WooCommerce products are included in the search, enable this option to display their current prices directly inside the live results.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Live Results Product Status<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">When WooCommerce products are included in the search, enable this option to display relevant product status information directly inside the live results. This can include states such as <strong>In Stock<\/strong>, <strong>Out of Stock<\/strong> or <strong>On Sale<\/strong>, helping visitors understand a product&#8217;s availability or current status before opening it.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Search Through Criteria<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Choose which content types should be included when a visitor performs a search. Depending on your WordPress configuration, the available choices can include <strong>Posts<\/strong>, <strong>Pages<\/strong>, <strong>Products<\/strong> and compatible Custom Post Types registered by other plugins.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This lets you keep the search focused on the content that is relevant to your website instead of querying every available post type.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Search Through Taxonomies<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Enable <strong>Search Through Taxonomies<\/strong> to include taxonomy terms in search queries alongside content from the selected post types. This allows visitors to find relevant categories, tags and other registered taxonomy terms in addition to individual posts, pages, products and Custom Post Types.<\/p>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>The Search element gives visitors quick access to your website&#8217;s search functionality directly from the header. Selecting the element opens a search overlay where visitors can enter their query and, when enabled, see matching results as they type. Searches can include standard WordPress content such as posts and pages, WooCommerce products, and compatible Custom Post [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":6203,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[124],"class_list":["post-6187","documentation","type-documentation","status-publish","has-post-thumbnail","hentry","doc_categories-header-elements"],"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/6187","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=6187"}],"version-history":[{"count":3,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/6187\/revisions"}],"predecessor-version":[{"id":15276,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/6187\/revisions\/15276"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media\/6203"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=6187"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=6187"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}