{"id":71061,"date":"2016-03-04T10:02:09","date_gmt":"2016-03-04T10:02:09","guid":{"rendered":"http:\/\/www.esri.com\/arcgis-blog\/products\/product\/uncategorized\/setting-up-a-searchable-feature-layer-in-configurable-apps\/"},"modified":"2018-03-26T21:08:04","modified_gmt":"2018-03-26T21:08:04","slug":"setting-up-a-searchable-feature-layer-in-configurable-apps","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps","title":{"rendered":"Setting Up a Searchable Feature Layer in Configurable Apps"},"author":6781,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[37511],"tags":[24421],"industry":[],"product":[36821,36551],"class_list":["post-71061","blog","type-blog","status-publish","format-standard","hentry","category-sharing-collaboration","tag-templates","product-configurable-apps","product-arcgis-online"],"acf":{"short_description":"There are a wide variety of configurable apps offered in the ArcGIS Online gallery that provide many types of functionality for interacti...","flexible_content":[{"acf_fc_layout":"content","content":"

There are a wide variety of configurable apps offered in the ArcGIS Online gallery<\/a> that provide many types of functionality for interacting with web maps. \u00a0A common functionality included in most configurable apps is the ability to search within the map<\/a>. \u00a0Search can be configured using a geocoder such as the Esri World Geocoding Service, or a searchable feature layer<\/a> contained in the web map. \u00a0By default, search is usually configured to use the Esri World Geocoder. \u00a0Other search sources, such as custom geocoders or searchable feature layers, must be enabled manually within the app’s configuration. \u00a0There are a few steps that are necessary for setting up a searchable feature layer besides enabling search.<\/p>\n

\"\"<\/a><\/p>\n

Apps that support search have a “Search” tab in the configuration panel where all parameters are located. This includes a list of all available search sources.<\/p>\n

\"\"<\/a><\/p>\n

If a searchable feature layer is detected in the web map, it will appear in this list identified by the layer name. \u00a0Follow these steps to successfully enable a searchable feature layer:<\/p>\n

1)<\/strong> If necessary, enable the search tool. \u00a0This will usually be a check box near the top of the Search tab.<\/p>\n

2)<\/strong> Enable the searchable feature layer. \u00a0To do this, check the check box next to the layer name in the list.<\/p>\n

3)<\/strong> Declare a search field. \u00a0Access this by clicking the Edit button next to the layer name in the list and then choose from the ‘Search Fields’ list on the resulting window. \u00a0*Note: This step is mandatory. \u00a0You must declare a search field for search by feature layer to work.<\/p>\n

These three steps will successfully establish a searchable feature layer as a valid search source to be used in the app. \u00a0However, within the Edit window from Step 3, there are various optional parameters that can be used \u00a0to more effectively control the performance and behavior of the searchable feature layer.<\/p>\n

\"\"<\/a><\/p>\n

The following are offered:<\/p>\n

Name<\/strong> – Choose a custom name for the search source.<\/p>\n

Placeholder<\/strong> – Determine the preset text shown in the search box before a search value is typed. \u00a0Think of this as help text or hint text.<\/p>\n

Constrain search within map<\/strong> – Choose to only find features that are within the extent of the map. \u00a0This is the extent saved at the web map level.<\/p>\n

Enable Suggestions<\/strong> – As a search value is being typed, potential matches will appear in a drop down list if this is enabled.<\/p>\n

Maximum Suggestions<\/strong> – Choose the max number of suggestions that will be offered at a time in the drop down list.<\/p>\n

Display Suggestions<\/strong> – This will control how the suggestions are displayed in the suggestion drop down list. \u00a0Choose between ‘Field’ or ‘Template’. \u00a0‘Field’ will display the suggestions as a specified field’s value. \u00a0‘Template’ will allow customization of this display by adding text and field values together. \u00a0Example:<\/p>\n

\"\"<\/a>\"\"<\/a><\/p>\n

Exact Match<\/strong> – This will limit search results to only results that exactly match the value typed in the search box.<\/p>\n

The search experience can be tested by clicking the View button on the bottom right of the configuration panel. \u00a0Once finished, don’t forget to save the changes that have been made.<\/p>\n"}],"authors":[{"ID":6781,"user_firstname":"Matthew","user_lastname":"Payne","nickname":"Matt Payne","user_nicename":"mattpayne","display_name":"Matt Payne","user_email":"MPayne@esri.com","user_url":"","user_registered":"2018-03-02 00:18:48","user_description":"Product Engineer with Instant Apps. Competitive distance runner, lover of weather, mountains, and hoops.","user_avatar":""}]},"yoast_head":"\nSetting Up a Searchable Feature Layer in Configurable Apps<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Setting Up a Searchable Feature Layer in Configurable Apps\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\" \/>\n<meta property=\"og:site_name\" content=\"ArcGIS Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/esrigis\/\" \/>\n<meta property=\"article:modified_time\" content=\"2018-03-26T21:08:04+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@ESRI\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"Article\",\"BlogPosting\"],\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\"},\"author\":{\"name\":\"Matt Payne\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/711568846af92ed759e6fed2cf07a13d\"},\"headline\":\"Setting Up a Searchable Feature Layer in Configurable Apps\",\"datePublished\":\"2016-03-04T10:02:09+00:00\",\"dateModified\":\"2018-03-26T21:08:04+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\"},\"wordCount\":9,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"keywords\":[\"templates\"],\"articleSection\":[\"Sharing and Collaboration\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\",\"name\":\"Setting Up a Searchable Feature Layer in Configurable Apps\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\"},\"datePublished\":\"2016-03-04T10:02:09+00:00\",\"dateModified\":\"2018-03-26T21:08:04+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.esri.com\/arcgis-blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Setting Up a Searchable Feature Layer in Configurable Apps\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"name\":\"ArcGIS Blog\",\"description\":\"Get insider info from Esri product teams\",\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\",\"name\":\"Esri\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"contentUrl\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"width\":400,\"height\":400,\"caption\":\"Esri\"},\"image\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/esrigis\/\",\"https:\/\/x.com\/ESRI\",\"https:\/\/www.linkedin.com\/company\/5311\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/711568846af92ed759e6fed2cf07a13d\",\"name\":\"Matt Payne\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/IMG_5541.jpg\",\"contentUrl\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/IMG_5541.jpg\",\"caption\":\"Matt Payne\"},\"description\":\"Product Engineer with Instant Apps. Competitive distance runner, lover of weather, mountains, and hoops.\",\"sameAs\":[\"https:\/\/x.com\/mattpayne2213\"],\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/author\/mattpayne\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Setting Up a Searchable Feature Layer in Configurable Apps","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps","og_locale":"en_US","og_type":"article","og_title":"Setting Up a Searchable Feature Layer in Configurable Apps","og_url":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps","og_site_name":"ArcGIS Blog","article_publisher":"https:\/\/www.facebook.com\/esrigis\/","article_modified_time":"2018-03-26T21:08:04+00:00","twitter_card":"summary_large_image","twitter_site":"@ESRI","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["Article","BlogPosting"],"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#article","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps"},"author":{"name":"Matt Payne","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/711568846af92ed759e6fed2cf07a13d"},"headline":"Setting Up a Searchable Feature Layer in Configurable Apps","datePublished":"2016-03-04T10:02:09+00:00","dateModified":"2018-03-26T21:08:04+00:00","mainEntityOfPage":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps"},"wordCount":9,"commentCount":0,"publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"keywords":["templates"],"articleSection":["Sharing and Collaboration"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps","url":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps","name":"Setting Up a Searchable Feature Layer in Configurable Apps","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#website"},"datePublished":"2016-03-04T10:02:09+00:00","dateModified":"2018-03-26T21:08:04+00:00","breadcrumb":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/sharing-collaboration\/sharing-collaboration\/setting-up-a-searchable-feature-layer-in-configurable-apps#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.esri.com\/arcgis-blog\/"},{"@type":"ListItem","position":2,"name":"Setting Up a Searchable Feature Layer in Configurable Apps"}]},{"@type":"WebSite","@id":"https:\/\/www.esri.com\/arcgis-blog\/#website","url":"https:\/\/www.esri.com\/arcgis-blog\/","name":"ArcGIS Blog","description":"Get insider info from Esri product teams","publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization","name":"Esri","url":"https:\/\/www.esri.com\/arcgis-blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","contentUrl":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","width":400,"height":400,"caption":"Esri"},"image":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/esrigis\/","https:\/\/x.com\/ESRI","https:\/\/www.linkedin.com\/company\/5311\/"]},{"@type":"Person","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/711568846af92ed759e6fed2cf07a13d","name":"Matt Payne","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/","url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/IMG_5541.jpg","contentUrl":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/IMG_5541.jpg","caption":"Matt Payne"},"description":"Product Engineer with Instant Apps. Competitive distance runner, lover of weather, mountains, and hoops.","sameAs":["https:\/\/x.com\/mattpayne2213"],"url":"https:\/\/www.esri.com\/arcgis-blog\/author\/mattpayne"}]}},"text_date":"March 4, 2016","author_name":"Matt Payne","author_page":"https:\/\/www.esri.com\/arcgis-blog\/author\/mattpayne","custom_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/08\/Newsroom-Keyart-Wide-1920-x-1080.jpg","primary_product":"ArcGIS Configurable Apps","tag_data":[{"term_id":24421,"name":"templates","slug":"templates","term_group":0,"term_taxonomy_id":24421,"taxonomy":"post_tag","description":"","parent":0,"count":61,"filter":"raw"}],"category_data":[{"term_id":37511,"name":"Sharing and Collaboration","slug":"sharing-collaboration","term_group":0,"term_taxonomy_id":37511,"taxonomy":"category","description":"","parent":0,"count":424,"filter":"raw"}],"product_data":[{"term_id":36821,"name":"ArcGIS Configurable Apps","slug":"configurable-apps","term_group":0,"term_taxonomy_id":36821,"taxonomy":"product","description":"","parent":36591,"count":94,"filter":"raw"},{"term_id":36551,"name":"ArcGIS Online","slug":"arcgis-online","term_group":0,"term_taxonomy_id":36551,"taxonomy":"product","description":"","parent":0,"count":2435,"filter":"raw"}],"primary_product_link":"https:\/\/www.esri.com\/arcgis-blog\/?s=#&products=configurable-apps","_links":{"self":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/71061","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/types\/blog"}],"author":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/users\/6781"}],"replies":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/comments?post=71061"}],"version-history":[{"count":0,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/71061\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/media?parent=71061"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/categories?post=71061"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/tags?post=71061"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/industry?post=71061"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/product?post=71061"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}