{"id":3965,"date":"2017-04-17T00:00:00","date_gmt":"2017-04-17T00:00:00","guid":{"rendered":"https:\/\/azure.microsoft.com\/blog\/azure-search-synonyms-public-preview"},"modified":"2025-06-17T09:03:20","modified_gmt":"2025-06-17T16:03:20","slug":"azure-search-synonyms-public-preview","status":"publish","type":"post","link":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/","title":{"rendered":"Azure Search releases support for synonyms (public preview)"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Today, we are happy to announce public preview support for synonyms in Azure Search, one of our most requested features on <a href=\"https:\/\/aka.ms\/azsuv\">UserVoice<\/a>. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match synonyms of the query terms.&nbsp;As a search-as-a-service solution, Azure Search is used in a wide variety of applications which span many languages, industries, and scenarios. Since <a href=\"https:\/\/azure.microsoft.com\/en-us\/resources\/cloud-computing-dictionary\" target=\"_blank\" rel=\"noopener\">terminology and definitions<\/a> vary from case to case, Azure Search\u2019s Synonyms API allows customers to define their own synonym mappings.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"synonyms-aim-to-increase-recall-without-sacrificing-relevance\">Synonyms aim to increase recall without sacrificing relevance<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Synonyms functionality in Azure Search allows a user to get more results for a given query without sacrificing how relevant those results are to the query terms. In a real estate website, for example, a user may be searching for \u2018jacuzzi.\u2019 If some of the listings only have the term \u2018hot tub\u2019 or \u2018whirlpool bath,\u2019 then the user will not see those results. When \u2018jacuzzi\u2019 and \u2018hot tub\u2019 are mapped to one another in a synonym map, Azure Search does not have to do any guess-work in understanding that these terms are relevant even though the terms bear no resemblance in spelling.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"multi-word-synonyms\">Multi-word synonyms<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In many full text search engines, support for synonyms is limited to single words. Our team has engineered a solution that allows Azure Search to support multi-word synonyms. This allows for phrase queries (\u201c\u201d) to function properly while using synonyms. If someone has mapped \u2018hot tub\u2019 to \u2018whirlpool bath\u2019 and they then search for \u201clarge hot tub,\u201d Azure Search will return matches which contain both \u201clarge hot tub\u201d and \u201clarge whirlpool bath.\u201d<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"support-for-solr-synonymfilterfactory-format\">Support for Solr SynonymFilterFactory format<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Azure Search\u2019s synonyms feature supports the same format used by <a href=\"https:\/\/aka.ms\/azssolrsynonymfilterfactory\">Apache Solr\u2019s SynonymFilterFactory<\/a>. As a widely-used open source standard, many existing synonym maps can be found for various languages and specific domains that can be used out-of-the box with Azure Search.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"creating-or-updating-a-synonym-map\">Creating or updating a synonym map<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Enabling synonyms functionality does not require any re-indexing of your content in Azure Search or any interruption of your service and you can add new synonyms at any time. Currently, the Synonyms API is in Public Preview and only available in the Service <a href=\"https:\/\/aka.ms\/azsrestsynonyms\">REST API<\/a> (api-version=2016-09-01-Preview) and <a href=\"https:\/\/aka.ms\/azsdotnetsynonyms\">.NET SDK<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When defining synonyms for Azure Search, you add a named resource to your search service called a <em>synonymMap<\/em>. You can enable synonyms for fields in your index by referring to the name of a synonymMap in the new <em>synonymMaps<\/em>&nbsp;property of the field definition.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Like an index definition, a synonym map is managed as an atomic resource that you read, update, or delete in a single operation. That means that if you want to make incremental changes to a synonym map, you will need to read, modify, and update the entire synonym map.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Below, there are some example operations using an example scenario of a real estate listings data set using the <a href=\"https:\/\/aka.ms\/azsrestsynonyms\">REST API<\/a>. For examples using the .NET SDK, please visit the <a href=\"https:\/\/aka.ms\/azsdotnetsynonyms\">documentation<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"post\">POST<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can create a new synonym map in the REST API using HTTP POST:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; auto-links: false; gutter: false; title: ; quick-code: false; notranslate\" title=\"\">\n\nPOST https:\/\/[servicename].search.windows.net\/synonymmaps?api-version=2016-09-01-Preview\napi-key: [admin key]\n\u00a0\n{\u00a0\n\u00a0\u00a0 \"name\":\"addressmap\",\n\u00a0\u00a0 \"format\":\"solr\",\n\u00a0\u00a0 \"synonyms\": \"\n\u00a0\u00a0\u00a0 \u00a0\u00a0Washington, Wash., WA => WAn\n\u00a0     USA, United States, United States of America\"\n}\n\n<\/pre><\/div>\n\n\n<h4 class=\"wp-block-heading\" id=\"put\">PUT<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">You can create a new synonym map or update an existing synonym map using HTTP PUT.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When using PUT, you must specify the synonym map name on the URI. If the synonym map does not exist, it will be created.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; auto-links: false; gutter: false; title: ; quick-code: false; notranslate\" title=\"\">\n\nPUT https:\/\/[servicename].search.windows.net\/synonymmaps\/addressmap?api-version=2016-09-01-Preview\napi-key: [admin key]\n\u00a0\n{\u00a0\n\u00a0\u00a0 \"name\":\"addressmap\",\n\u00a0\u00a0 \"format\":\"solr\",\n\u00a0\u00a0 \"synonyms\": \"\n      Washington, Wash., WA => WAn\n      USA, United States, United States of American\"\n}\n\n<\/pre><\/div>\n\n\n<h2 class=\"wp-block-heading\">&nbsp;<\/h2>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"types-of-synonym-mappings\">Types of synonym mappings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">With the Synonyms API, it is possible to define synonyms in two ways: one-way mappings and equivalence-class mappings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"one-way-mappings\">One-way mappings<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">With one-way mappings, Azure Search will treat multiple terms as if they all are a specific term. For example, the state where a property is located may only be stored as the two-letter abbreviation in the index for real estate listings. However, users may type in the full name of the state or other abbreviations.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; auto-links: false; gutter: false; title: ; quick-code: false; notranslate\" title=\"\">\n\n{\u00a0 \n\u00a0\u00a0 \"name\":\"addressmap\",\n\u00a0\u00a0 \"format\":\"solr\",\n\u00a0\u00a0 \"synonyms\": \"\n\u00a0\u00a0\u00a0 \u00a0\u00a0Washington, Wash., WA => WA\"\n}\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\" id=\"equivalence-class-mappings\">Equivalence-class mappings<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In many domains, there are terms which all have the same or similar meaning. The Synonyms API makes it simple to map all like terms to one another so that the search term is expanded at query-time to include all synonyms. The above example of the multiple ways to describe \u2018jacuzzi\u2019 is demonstrated below.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; auto-links: false; gutter: false; title: ; quick-code: false; notranslate\" title=\"\">\n\n{\u00a0 \n\u00a0\u00a0 \"name\":\"descriptionmap\",\n\u00a0\u00a0 \"format\":\"solr\",\n\u00a0\u00a0 \"synonyms\": \"hot tub, jacuzzi, whirlpool bath, sauna\"\n}\n\n<\/pre><\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"setting-the-synonym-map-in-the-index-definition\">Setting the synonym map in the index definition<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When defining a searchable field in your index, you can use the new property synonymMaps to specify a synonym map to use for the field. Multiple indexes in the same search service can refer to the same synonym map.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">NOTE: Currently only one synonym map per field is supported.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; auto-links: false; gutter: false; title: ; quick-code: false; notranslate\" title=\"\">\n\nPOST https:\/\/[servicename].search.windows.net\/indexes?api-version= 2016-09-01-Preview\napi-key: [admin key]\n\u00a0\n{\n\u00a0\u00a0 \"name\":\"realestateindex\",\n\u00a0\u00a0 \"fields\":[\n\u00a0\u00a0\u00a0\u00a0\u00a0 {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\u00a0\"name\":\"id\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"type\":\"Edm.String\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"key\":true\n\u00a0\u00a0\u00a0\u00a0\u00a0 },\n\u00a0\u00a0\u00a0\u00a0\u00a0 {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"name\":\"address\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"type\":\"Edm.String\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"searchable\":true,\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"analyzer\":\"en.lucene\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"synonymMaps\":[\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"addressmap\"\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ]\n\u00a0\u00a0\u00a0\u00a0\u00a0 },\n\u00a0\u00a0\u00a0\u00a0\u00a0 {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"name\":\"description\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"type\":\"Edm.String\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"searchable\":true,\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"analyzer\":\"en.lucene\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"synonymMaps\":[\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"descriptionmap\"\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ]\n\u00a0\u00a0\u00a0\u00a0\u00a0 }\n\u00a0\u00a0 ]\n}\n\n<\/pre><\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"synonyms-search-traffic-analytics\">Synonyms + Search Traffic Analytics<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Coupled with <a href=\"https:\/\/aka.ms\/azstainstructions\">Search Traffic Analytics (STA)<\/a>, synonyms can be powerful in improving the quality of the search results that end users see. STA in Azure Search reveals&nbsp;the most common queries with zero results. By adding relevant synonyms to these terms, these zero-result queries can be mitigated. STA also shows the most common query terms for your Azure Search service, so you do not need to guess when determining proper terms for your synonym map.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"learn-more\">Learn more<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You follow these links for the detailed documentation around synonyms using the <a href=\"https:\/\/aka.ms\/azsrestsynonyms\">REST API<\/a> and <a href=\"https:\/\/aka.ms\/azsdotnetsynonyms\">.NET SDK<\/a>. Read more about Azure Search and its&nbsp;<a href=\"https:\/\/aka.ms\/whatisazsearch\">capabilities<\/a>&nbsp;and visit our&nbsp;<a href=\"https:\/\/aka.ms\/azsearchdocs\">documentation<\/a>. Please visit our&nbsp;<a href=\"https:\/\/aka.ms\/azspricing\">pricing page<\/a>&nbsp;to learn about the various tiers of service to fit your needs.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ms_queue_id":[],"ep_exclude_from_search":false,"_classifai_error":"","_classifai_text_to_speech_error":"","_alt_title":"","footnotes":"","msx_community_cta_settings":[]},"categories":[1454],"tags":[],"audience":[3057,3055,3056],"content-type":[1465],"product":[2757],"tech-community":[],"topic":[],"coauthors":[97],"class_list":["post-3965","post","type-post","status-publish","format-standard","hentry","category-ai-machine-learning","audience-data-professionals","audience-developers","audience-it-implementors","content-type-announcements","product-azure-ai-search","review-flag-1680286581-295","review-flag-1680286581-56","review-flag-1680286581-364","review-flag-new-1680286579-546","review-flag-publi-1680286584-566"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog<\/title>\n<meta name=\"description\" content=\"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog\" \/>\n<meta property=\"og:description\" content=\"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Azure Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/microsoftazure\" \/>\n<meta property=\"article:published_time\" content=\"2017-04-17T00:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-17T16:03:20+00:00\" \/>\n<meta name=\"author\" content=\"Microsoft Azure\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@azure\" \/>\n<meta name=\"twitter:site\" content=\"@azure\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Microsoft Azure\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\"},\"author\":[{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/microsoft-azure\/\",\"@type\":\"Person\",\"@name\":\"Microsoft Azure\"}],\"headline\":\"Azure Search releases support for synonyms (public preview)\",\"datePublished\":\"2017-04-17T00:00:00+00:00\",\"dateModified\":\"2025-06-17T16:03:20+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\"},\"wordCount\":904,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\"},\"articleSection\":[\"AI + machine learning\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\",\"name\":\"Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog\",\"isPartOf\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#website\"},\"datePublished\":\"2017-04-17T00:00:00+00:00\",\"dateModified\":\"2025-06-17T16:03:20+00:00\",\"description\":\"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.\",\"breadcrumb\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blog home\",\"item\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AI + machine learning\",\"item\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/category\/ai-machine-learning\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Azure Search releases support for synonyms (public preview)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#website\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\",\"name\":\"Microsoft Azure Blog\",\"description\":\"Get the latest Azure news, updates, and announcements from the Azure blog. From product updates to hot topics, hear from the Azure experts.\",\"publisher\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization\",\"name\":\"Microsoft Azure Blog\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp\",\"contentUrl\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp\",\"width\":512,\"height\":512,\"caption\":\"Microsoft Azure Blog\"},\"image\":{\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/microsoftazure\",\"https:\/\/x.com\/azure\",\"https:\/\/www.instagram.com\/microsoftdeveloper\/\",\"https:\/\/www.linkedin.com\/company\/16188386\",\"https:\/\/www.youtube.com\/user\/windowsazure\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/person\/c702e5edd662b328b49b7e1180cab117\",\"name\":\"shakir\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g7664e653ea371ce16eaf75e9fa8952c4\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g\",\"caption\":\"shakir\"},\"sameAs\":[\"https:\/\/azure.microsoft.com\"],\"url\":\"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/shakir\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog","description":"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.","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:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/","og_locale":"en_US","og_type":"article","og_title":"Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog","og_description":"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.","og_url":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/","og_site_name":"Microsoft Azure Blog","article_publisher":"https:\/\/www.facebook.com\/microsoftazure","article_published_time":"2017-04-17T00:00:00+00:00","article_modified_time":"2025-06-17T16:03:20+00:00","author":"Microsoft Azure","twitter_card":"summary_large_image","twitter_creator":"@azure","twitter_site":"@azure","twitter_misc":{"Written by":"Microsoft Azure","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#article","isPartOf":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/"},"author":[{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/microsoft-azure\/","@type":"Person","@name":"Microsoft Azure"}],"headline":"Azure Search releases support for synonyms (public preview)","datePublished":"2017-04-17T00:00:00+00:00","dateModified":"2025-06-17T16:03:20+00:00","mainEntityOfPage":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/"},"wordCount":904,"commentCount":0,"publisher":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization"},"articleSection":["AI + machine learning"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/","name":"Azure Search releases support for synonyms (public preview) | Microsoft Azure Blog","isPartOf":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#website"},"datePublished":"2017-04-17T00:00:00+00:00","dateModified":"2025-06-17T16:03:20+00:00","description":"Azure Search releases Public Preview availability for multi-word synonyms. Synonyms functionality allows for Azure Search to not only return results which match the query terms that were typed into the search box, but also return results which match customer-defined synonyms of the query terms.","breadcrumb":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/azure-search-synonyms-public-preview\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Blog home","item":"https:\/\/azure.microsoft.com\/en-us\/blog\/"},{"@type":"ListItem","position":2,"name":"AI + machine learning","item":"https:\/\/azure.microsoft.com\/en-us\/blog\/category\/ai-machine-learning\/"},{"@type":"ListItem","position":3,"name":"Azure Search releases support for synonyms (public preview)"}]},{"@type":"WebSite","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#website","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/","name":"Microsoft Azure Blog","description":"Get the latest Azure news, updates, and announcements from the Azure blog. From product updates to hot topics, hear from the Azure experts.","publisher":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/azure.microsoft.com\/en-us\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#organization","name":"Microsoft Azure Blog","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp","contentUrl":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-content\/uploads\/2024\/06\/microsoft_logo.webp","width":512,"height":512,"caption":"Microsoft Azure Blog"},"image":{"@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/microsoftazure","https:\/\/x.com\/azure","https:\/\/www.instagram.com\/microsoftdeveloper\/","https:\/\/www.linkedin.com\/company\/16188386","https:\/\/www.youtube.com\/user\/windowsazure"]},{"@type":"Person","@id":"https:\/\/azure.microsoft.com\/en-us\/blog\/#\/schema\/person\/c702e5edd662b328b49b7e1180cab117","name":"shakir","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g7664e653ea371ce16eaf75e9fa8952c4","url":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/9342c7c05bb16548741bc5cd3a3e3b7ee0c8e746844ad2cc582db5beb5514c6f?s=96&d=mm&r=g","caption":"shakir"},"sameAs":["https:\/\/azure.microsoft.com"],"url":"https:\/\/azure.microsoft.com\/en-us\/blog\/author\/shakir\/"}]}},"msxcm_display_generated_audio":false,"msxcm_animated_featured_image":null,"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Azure Blog","distributor_original_site_url":"https:\/\/azure.microsoft.com\/en-us\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/3965","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/comments?post=3965"}],"version-history":[{"count":1,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/3965\/revisions"}],"predecessor-version":[{"id":42103,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/posts\/3965\/revisions\/42103"}],"wp:attachment":[{"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/media?parent=3965"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/categories?post=3965"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/tags?post=3965"},{"taxonomy":"audience","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/audience?post=3965"},{"taxonomy":"content-type","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/content-type?post=3965"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/product?post=3965"},{"taxonomy":"tech-community","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/tech-community?post=3965"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/topic?post=3965"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/azure.microsoft.com\/en-us\/blog\/wp-json\/wp\/v2\/coauthors?post=3965"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}