{"id":365489,"date":"2025-10-08T12:58:51","date_gmt":"2025-10-08T06:58:51","guid":{"rendered":"https:\/\/directorist.com\/?post_type=docs&#038;p=365489"},"modified":"2025-10-28T08:35:47","modified_gmt":"2025-10-28T02:35:47","password":"","slug":"search-listing-page-setup","status":"publish","type":"docs","link":"https:\/\/directorist.com\/docs\/search-listing-page-setup\/","title":{"rendered":"Search Page"},"content":{"rendered":"\n<p>The&nbsp;<strong>Search Listing Settings<\/strong>&nbsp;control how the search section appears and functions on your directory\u2019s search results page. In Directorist, search behavior is divided between two configuration areas<span style=\"margin: 0px;padding: 0px\">:<\/span>&nbsp;<strong>Global Settings<\/strong>&nbsp;and the&nbsp;<strong>Directory Builder<\/strong>, each responsible for different parts of the search experience.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-1024x300.png\" alt=\"\" class=\"wp-image-365639\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-1024x300.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-300x88.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-768x225.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-1536x450.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-44-2048x600.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Global Settings<\/strong><\/h2>\n\n\n\n<p>Global Settings control the&nbsp;<strong>overall appearance and layout<\/strong>&nbsp;of the search section across your website \u2014 including the search bar, filter options, and category display on the search results page.<\/p>\n\n\n\n<p>These settings are found under: <strong>Directorist \u2192 Settings \u2192 Search \u2192 Search Listing<\/strong><\/p>\n\n\n\n<p>When you install Directorist, the plugin automatically creates the&nbsp;<strong>Search Page<\/strong>. If the page is missing or not functioning correctly, you can recreate it manually:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Create a new page from&nbsp;<strong>WordPress Dashboard \u2192 Pages \u2192 Add New<\/strong>.<\/li>\n\n\n\n<li>Add the following shortcode to the page content area:<code>[directorist_search_listing]<\/code><\/li>\n\n\n\n<li>Assign the page via&nbsp;<strong>Directorist Settings \u2192 Page Setup \u2192 Pages, Links, and Views \u2192 Listing Search Page<\/strong>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"543\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-1024x543.png\" alt=\"\" class=\"wp-image-365491\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-1024x543.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-300x159.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-768x407.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-1536x815.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-35-2048x1086.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"346\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37-1024x346.png\" alt=\"\" class=\"wp-image-365493\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37-1024x346.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37-300x101.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37-768x260.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37-1536x519.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-37.png 2012w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Search Bar<\/strong><\/h3>\n\n\n\n<p><strong>Search Bar Title<\/strong><br>Enter the title displayed at the top of the search bar.<br><em>Default: \u201cSearch here\u201d<\/em><\/p>\n\n\n\n<p><strong>Search Bar Sub-title<\/strong><br>Add a short descriptive line under the title to guide users.<br><em>Default: \u201cFind the best match of your interest\u201d<\/em><\/p>\n\n\n\n<p><strong>Search Button Text<\/strong><br>Customize the label on the search button.<br><em>Default: \u201cSearch Listing\u201d<\/em><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"377\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-1024x377.png\" alt=\"\" class=\"wp-image-365494\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-1024x377.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-300x110.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-768x283.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-1536x565.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-38-2048x754.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Search Bar &#8211; Front-end view<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"230\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-1024x230.png\" alt=\"\" class=\"wp-image-365496\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-1024x230.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-300x67.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-768x172.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-1536x344.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-40-2048x459.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Filters<\/strong><\/h3>\n\n\n\n<p><strong>Display More Filters<\/strong><br>Enable this to display additional filtering options on the search form.<br>Useful when you have multiple filter fields like category, price range, location, etc.<\/p>\n\n\n\n<p><strong>More Filters Button Text<\/strong><br>Customize the text for the \u201cMore Filters\u201d toggle button.<br><em>Default: \u201cMore Filters\u201d<\/em><\/p>\n\n\n\n<p><strong>Filter Actions<\/strong><br>Choose which filter actions appear below the filter area:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Reset<\/strong>&nbsp;\u2013 Clears all applied filters.<\/li>\n\n\n\n<li><strong>Apply<\/strong>&nbsp;\u2013 Applies the selected filters to show relevant listings.<\/li>\n<\/ul>\n\n\n\n<p><strong>Reset Button Text<\/strong><br>Change the label of the reset button.<br><em>Default: \u201cReset Filters\u201d<\/em><\/p>\n\n\n\n<p><strong>Apply Button Text<\/strong><br>Change the label of the apply button.<br><em>Default: \u201cApply Filters\u201d<\/em><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"593\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39-1024x593.png\" alt=\"\" class=\"wp-image-365495\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39-1024x593.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39-300x174.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39-768x445.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39-1536x889.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-39.png 2000w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Filter &#8211; Front-end view<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"870\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42-1024x870.png\" alt=\"\" class=\"wp-image-365498\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42-1024x870.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42-300x255.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42-768x653.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42-1536x1305.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-42.png 1998w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>3. Popular Categories<\/strong><\/h4>\n\n\n\n<p><strong>Display Popular Categories<\/strong><br>Enable this to show popular categories directly within the search section, allowing users to quickly browse trending listing types.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Front-end view<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"272\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-1024x272.png\" alt=\"\" class=\"wp-image-365502\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-1024x272.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-300x80.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-768x204.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-1536x408.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-43-2048x544.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Directory Builder <\/strong><\/h2>\n\n\n\n<p>The&nbsp;<strong>Directory Builder<\/strong>&nbsp;controls the&nbsp;<strong>search form fields,<\/strong>&nbsp;meaning the actual elements inside the search form such as \u201cWhat are you looking for?\u201d, \u201cLocation\u201d, \u201cCategory\u201d, or any custom field. Each directory type can have its own unique search structure.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>Search Form Structure<\/strong><\/h4>\n\n\n\n<p>The search form is organized into two main groups:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Basic Section<\/strong>&nbsp;\u2013 Common search fields used by most directories.<\/li>\n\n\n\n<li><strong>Advanced Section<\/strong>&nbsp;\u2013 Optional or extended filters for refined search control.<\/li>\n<\/ul>\n\n\n\n<p>You can&nbsp;<strong>drag and drop<\/strong>&nbsp;any field to reorder it, add new ones, or remove unnecessary fields.<\/p>\n\n\n\n<p>Access it via: <strong>Directorist \u2192 Directory Builder \u2192 Search Form<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"356\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-1024x356.png\" alt=\"\" class=\"wp-image-369326\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-1024x356.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-300x104.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-768x267.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-1536x534.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-132-2048x712.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Basic Fields<\/strong><\/h3>\n\n\n\n<p>Common default fields include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>What are you looking for?<\/strong>&nbsp;\u2013 A general keyword search field.<\/li>\n\n\n\n<li><strong>Location<\/strong>&nbsp;\u2013 Helps users search listings based on location data. <strong>Location<\/strong>&nbsp;field can be customized with the following options:\n<ul class=\"wp-block-list\">\n<li><strong>Location Source<\/strong>&nbsp;\u2013 Choose how location data is displayed:<\/li>\n\n\n\n<li><strong>Display from Listing Location<\/strong>&nbsp;\u2013 Pulls location from the directory\u2019s location taxonomy.<\/li>\n\n\n\n<li><strong>Display from Map API<\/strong>&nbsp;\u2013 Fetches live results from your integrated map provider (Google Map or OpenStreetMap).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Category<\/strong>&nbsp;\u2013 Enables users to narrow down listings by category.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"410\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-1024x410.png\" alt=\"\" class=\"wp-image-369328\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-1024x410.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-300x120.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-768x308.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-1536x615.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-133-2048x820.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Advanced Fields<\/strong><\/h3>\n\n\n\n<p>The&nbsp;<strong>Advanced<\/strong>&nbsp;section provides additional filters for precise search results. Common advanced fields include:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>1. Pricing<\/strong><\/h4>\n\n\n\n<p>Lets users search listings by price range.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Price Type<\/strong>&nbsp;\u2013 Choose between:\n<ul class=\"wp-block-list\">\n<li><strong>Max-Min<\/strong>&nbsp;\u2013 Displays two fields (minimum and maximum price).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>This is ideal for directories like real estate, car sales, or rentals.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>2. Review<\/strong><\/h4>\n\n\n\n<p>Displays listings based on average user ratings. Users can filter to view higher-rated listings.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>3. Tags<\/strong><\/h4>\n\n\n\n<p>Allows users to search by listing tags. Useful when listings are tagged with features like \u201cFamily-friendly,\u201d \u201cPet allowed,\u201d etc.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>4. Radius Search<\/strong><\/h4>\n\n\n\n<p>Helps users find listings within a specified distance from a chosen location.<\/p>\n\n\n\n<p><strong>Settings available:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Label<\/strong>&nbsp;\u2013 Customize the field title (e.g., \u201cSearch Nearby\u201d).<\/li>\n\n\n\n<li><strong>Default Radius Distance<\/strong>&nbsp;\u2013 Set a default search radius (e.g., 0 or 5 miles).<\/li>\n\n\n\n<li><strong>Maximum Radius Distance<\/strong>&nbsp;\u2013 Define the furthest searchable distance (e.g., 1000 miles).<\/li>\n\n\n\n<li><strong>Radius Search Unit<\/strong>&nbsp;\u2013 Choose the unit (Miles or Kilometers).<\/li>\n\n\n\n<li><strong>Radius Search Based On<\/strong>&nbsp;\u2013 Select whether distance is calculated from:\n<ul class=\"wp-block-list\">\n<li><strong>Address<\/strong>&nbsp;\u2013 Uses the full address field.<\/li>\n\n\n\n<li><strong>Zip Code<\/strong>&nbsp;\u2013 Uses postal codes for calculation.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"441\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-1024x441.png\" alt=\"\" class=\"wp-image-369329\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-1024x441.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-300x129.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-768x331.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-1536x662.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-134-2048x883.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Extending the Search Form<\/strong><\/h3>\n\n\n\n<p>These fields represent the&nbsp;<strong>core search options<\/strong>&nbsp;available in the Directorist plugin. However, you can extend the search capabilities further using additional&nbsp;<a href=\"https:\/\/directorist.com\/extensions\/\" data-type=\"link\" data-id=\"https:\/\/directorist.com\/extensions\/\"><strong>Directorist extensions<\/strong>.<\/a> <\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The&nbsp;Search Listing Settings&nbsp;control how the search section appears and functions on your directory\u2019s search results page. In Directorist, search behavior is divided between two configuration areas:&nbsp;Global Settings&nbsp;and the&nbsp;Directory Builder, each responsible for different parts of the search experience. Global Settings Global Settings control the&nbsp;overall appearance and layout&nbsp;of the search section across your website \u2014 including [&hellip;]<\/p>\n","protected":false},"author":24585,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[704],"doc_tag":[],"class_list":["post-365489","docs","type-docs","status-publish","hentry","doc_category-search-and-filter-settings"],"year_month":"2026-03","word_count":730,"total_views":"0","reactions":{"happy":"0","normal":"1","sad":"0"},"author_info":{"name":"yousuf.sovware","author_nicename":"yousuf-sovware","author_url":"https:\/\/directorist.com\/author\/yousuf-sovware\/"},"doc_category_info":[{"term_name":"Search and Filter Settings","term_url":"https:\/\/directorist.com\/docs-category\/search-and-filter-settings\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/365489","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/users\/24585"}],"replies":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/comments?post=365489"}],"version-history":[{"count":0,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/365489\/revisions"}],"wp:attachment":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/media?parent=365489"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_category?post=365489"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_tag?post=365489"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}