# Need some n00b help: how do I install and set up synonyms file? **URL:** \ **Category:** Elasticsearch\ **Created:** [January 22, 2015, 8:57pm UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785 "2015-01-22T20:57:51Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![james\_rubinstein](https://avatars.discourse-cdn.com/v4/letter/j/76d3ee/32.png) [@james\_rubinstein](https://discuss.elastic.co/u/james_rubinstein)\ **Post date:** [January 22, 2015, 8:57pm UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/1 "2015-01-22T20:57:51Z")
Hi all, I'm new to using ES, but have so far found the process quite intuitive. I've installed ES, set up an index, indexed a bunch of JSON documents, and I can search them. Hooray! However, I want to start using synonyms for a few queries. I'd like to do this at query time using a synonym file. How can I install the synonym file and have ES read it? I'm using elasticsearch-1.4.1 on Mac OSX locally. I've read through the docs [http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html) but I still don't understand what to do because I'm still not seeing queries that use the synonym I've defined. POST /test/\_settings { "index" : { "analysis" : { "analyzer" : { "synonym" : { "tokenizer" : "whitespace", "filter" : ["synonym"] } }, "filter" : { "synonym" : { "type" : "synonym", "synonyms\_path" : "analysis/synonym.txt" } } } } } My synonym file has one line: "clementine =\> clementine,mandarin,orange,citrus" When I search for "Clementine" on my index I get 3 results, searching for "Orange" gets me 66. Thanks, JR -- You received this message because you are subscribed to the Google Groups "elasticsearch" group. To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/d9043a12-8cd3-47fa-9800-5041215a6816%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/d9043a12-8cd3-47fa-9800-5041215a6816%40googlegroups.com). For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). ---
**Author:** ![james\_rubinstein](https://avatars.discourse-cdn.com/v4/letter/j/76d3ee/32.png) [@james\_rubinstein](https://discuss.elastic.co/u/james_rubinstein)\ **Post date:** [January 22, 2015, 9:45pm UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/2 "2015-01-22T21:45:04Z")
Also, I tried this: curl -XPUT 'localhost:9200/test/\_settings' -d ' > { > ``` > "index" : { > > ``` > ``` > "analysis" : { > > ``` > ``` > "analyzer" : { > > ``` > ``` > "synonym" : { > > ``` > ``` > "tokenizer" : "whitespace", > > ``` > ``` > "filter" : ["synonym"] > > ``` > ``` > } > > ``` > ``` > }, > > ``` > ``` > "filter" : { > > ``` > ``` > "synonym" : { > > ``` > ``` > "type" : "synonym", > > ``` > ``` > "synonyms_path" : "analysis/synonym.txt" > > ``` > ``` > } > > ``` > ``` > } > > ``` > ``` > } > > ``` > ``` > } > > ``` > }' Which gives the response : {"acknowledged":true} , but it still didn't change the outcome when querying On Thursday, January 22, 2015 at 12:57:51 PM UTC-8, james rubinstein wrote: > Hi all, > I'm new to using ES, but have so far found the process quite intuitive. > I've installed ES, set up an index, indexed a bunch of JSON documents, and > I can search them. Hooray! > However, I want to start using synonyms for a few queries. I'd like to do > this at query time using a synonym file. How can I install the synonym file > and have ES read it? > I'm using elasticsearch-1.4.1 on Mac OSX locally. > > I've read through the docs > [http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html) but > I still don't understand what to do because I'm still not seeing queries > that use the synonym I've defined. > > POST /test/\_settings > { > "index" : { > "analysis" : { > "analyzer" : { > "synonym" : { > "tokenizer" : "whitespace", > "filter" : ["synonym"] > } > }, > "filter" : { > "synonym" : { > "type" : "synonym", > "synonyms\_path" : "analysis/synonym.txt" > } > } > } > } > } > > My synonym file has one line: > > "clementine =\> clementine,mandarin,orange,citrus" > > When I search for "Clementine" on my index I get 3 results, searching for > "Orange" gets me 66. > > Thanks, > JR -- You received this message because you are subscribed to the Google Groups "elasticsearch" group. To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com). For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). ---
**Author:** ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)\ **Post date:** [January 22, 2015, 11:37pm UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/3 "2015-01-22T23:37:09Z")
The path needs to be relative to the config home for ES. Take a look at > **[Elasticsearch Platform — Find real-time answers at scale](https://www.elastic.co)** > > Power insights and outcomes with the Elasticsearch Platform and AI. See into your data and find answers that matter with enterprise solutions designed to help you build, observe, and protect. Try Elasticsearch free today. for where that would be on your installation. On 23 January 2015 at 08:45, james rubinstein [rubinstein.james@gmail.com](mailto:rubinstein.james@gmail.com) wrote: > Also, I tried this: > > curl -XPUT 'localhost:9200/test/\_settings' -d ' > > > { > > > ``` > > "index" : { > > > > ``` > > > ``` > > "analysis" : { > > > > ``` > > > ``` > > "analyzer" : { > > > > ``` > > > ``` > > "synonym" : { > > > > ``` > > > ``` > > "tokenizer" : "whitespace", > > > > ``` > > > ``` > > "filter" : ["synonym"] > > > > ``` > > > ``` > > } > > > > ``` > > > ``` > > }, > > > > ``` > > > ``` > > "filter" : { > > > > ``` > > > ``` > > "synonym" : { > > > > ``` > > > ``` > > "type" : "synonym", > > > > ``` > > > ``` > > "synonyms_path" : "analysis/synonym.txt" > > > > ``` > > > ``` > > } > > > > ``` > > > ``` > > } > > > > ``` > > > ``` > > } > > > > ``` > > > ``` > > } > > > > ``` > > > }' > > Which gives the response : {"acknowledged":true} , but it still didn't > change the outcome when querying > > On Thursday, January 22, 2015 at 12:57:51 PM UTC-8, james rubinstein wrote: > > > Hi all, > > I'm new to using ES, but have so far found the process quite intuitive. > > I've installed ES, set up an index, indexed a bunch of JSON documents, and > > I can search them. Hooray! > > However, I want to start using synonyms for a few queries. I'd like to do > > this at query time using a synonym file. How can I install the synonym file > > and have ES read it? > > I'm using elasticsearch-1.4.1 on Mac OSX locally. > > > > I've read through the docs > > [http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html) but > > I still don't understand what to do because I'm still not seeing queries > > that use the synonym I've defined. > > > > POST /test/\_settings > > { > > "index" : { > > "analysis" : { > > "analyzer" : { > > "synonym" : { > > "tokenizer" : "whitespace", > > "filter" : ["synonym"] > > } > > }, > > "filter" : { > > "synonym" : { > > "type" : "synonym", > > "synonyms\_path" : "analysis/synonym.txt" > > } > > } > > } > > } > > } > > > > My synonym file has one line: > > > > "clementine =\> clementine,mandarin,orange,citrus" > > > > When I search for "Clementine" on my index I get 3 results, searching for > > "Orange" gets me 66. > > > > Thanks, > > JR > > > > -- > > You received this message because you are subscribed to the Google Groups > > "elasticsearch" group. > > To unsubscribe from this group and stop receiving emails from it, send an > > email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). > > To view this discussion on the web visit > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com) > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm\_medium=email&utm\_source=footer](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm_medium=email&utm_source=footer) > > . > > For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). -- You received this message because you are subscribed to the Google Groups "elasticsearch" group. To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/CAEYi1X\_tzjwDNGu6\_nVqoQWdtg9DuKSagXCvw4CuSCgz0jaKmw%40mail.gmail.com](https://groups.google.com/d/msgid/elasticsearch/CAEYi1X_tzjwDNGu6_nVqoQWdtg9DuKSagXCvw4CuSCgz0jaKmw%40mail.gmail.com). For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). ---
**Author:** ![james\_rubinstein](https://avatars.discourse-cdn.com/v4/letter/j/76d3ee/32.png) [@james\_rubinstein](https://discuss.elastic.co/u/james_rubinstein)\ **Post date:** [January 23, 2015, 12:50am UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/4 "2015-01-23T00:50:00Z")
Thanks Mark, I believe that I have done that (but perhaps not) My file is located at /Users/jrubinstein/dev/elasticsearch/elasticsearch-1.4.1/config/analysis the YML files are in the 'config' directory. On Thursday, January 22, 2015 at 3:37:39 PM UTC-8, Mark Walkom wrote: > The path needs to be relative to the config home for ES. > > Take a look at > [Elasticsearch Platform — Find real-time answers at scale | Elastic](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/setup-dir-layout.html#default-paths) > for where that would be on your installation. > > On 23 January 2015 at 08:45, james rubinstein \<[rubinste...@gmail.com](mailto:rubinste...@gmail.com) > \\> wrote: > > > Also, I tried this: > > > > curl -XPUT 'localhost:9200/test/\_settings' -d ' > > > > > { > > > > > ``` > > > "index" : { > > > > > > ``` > > > > > ``` > > > "analysis" : { > > > > > > ``` > > > > > ``` > > > "analyzer" : { > > > > > > ``` > > > > > ``` > > > "synonym" : { > > > > > > ``` > > > > > ``` > > > "tokenizer" : "whitespace", > > > > > > ``` > > > > > ``` > > > "filter" : ["synonym"] > > > > > > ``` > > > > > ``` > > > } > > > > > > ``` > > > > > ``` > > > }, > > > > > > ``` > > > > > ``` > > > "filter" : { > > > > > > ``` > > > > > ``` > > > "synonym" : { > > > > > > ``` > > > > > ``` > > > "type" : "synonym", > > > > > > ``` > > > > > ``` > > > "synonyms_path" : "analysis/synonym.txt" > > > > > > ``` > > > > > ``` > > > } > > > > > > ``` > > > > > ``` > > > } > > > > > > ``` > > > > > ``` > > > } > > > > > > ``` > > > > > ``` > > > } > > > > > > ``` > > > > > }' > > > > Which gives the response : {"acknowledged":true} , but it still didn't > > change the outcome when querying > > > > On Thursday, January 22, 2015 at 12:57:51 PM UTC-8, james rubinstein > > wrote: > > > > > Hi all, > > > I'm new to using ES, but have so far found the process quite intuitive. > > > I've installed ES, set up an index, indexed a bunch of JSON documents, and > > > I can search them. Hooray! > > > However, I want to start using synonyms for a few queries. I'd like to > > > do this at query time using a synonym file. How can I install the synonym > > > file and have ES read it? > > > I'm using elasticsearch-1.4.1 on Mac OSX locally. > > > > > > I've read through the docs > > > [http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html) but > > > I still don't understand what to do because I'm still not seeing queries > > > that use the synonym I've defined. > > > > > > POST /test/\_settings > > > { > > > "index" : { > > > "analysis" : { > > > "analyzer" : { > > > "synonym" : { > > > "tokenizer" : "whitespace", > > > "filter" : ["synonym"] > > > } > > > }, > > > "filter" : { > > > "synonym" : { > > > "type" : "synonym", > > > "synonyms\_path" : "analysis/synonym.txt" > > > } > > > } > > > } > > > } > > > } > > > > > > My synonym file has one line: > > > > > > "clementine =\> clementine,mandarin,orange,citrus" > > > > > > When I search for "Clementine" on my index I get 3 results, searching > > > for "Orange" gets me 66. > > > > > > Thanks, > > > JR > > > > > > -- > > > You received this message because you are subscribed to the Google Groups > > > "elasticsearch" group. > > > To unsubscribe from this group and stop receiving emails from it, send an > > > email to [elasticsearc...@googlegroups.com](mailto:elasticsearc...@googlegroups.com) \. > > > To view this discussion on the web visit > > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com) > > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm\_medium=email&utm\_source=footer](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm_medium=email&utm_source=footer) > > > . > > > > For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). -- You received this message because you are subscribed to the Google Groups "elasticsearch" group. To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/3c71663d-91d3-4bc2-861f-c2e156db34dc%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/3c71663d-91d3-4bc2-861f-c2e156db34dc%40googlegroups.com). For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). ---
**Author:** ![Thami\_Inaflas\_2](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/thami_inaflas_2/32/969_2.png) [@Thami\_Inaflas\_2](https://discuss.elastic.co/u/Thami_Inaflas_2)\ **Post date:** [January 23, 2015, 11:02am UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/5 "2015-01-23T11:02:57Z")
Hello, i guess you should re-index your data because you have changed the mapping, and check if this analysis is run on your query AND on your indexed data. I hope this helps you out, TI Le vendredi 23 janvier 2015 01:50:00 UTC+1, james rubinstein a écrit : > Thanks Mark, > I believe that I have done that (but perhaps not) > > My file is located at > > /Users/jrubinstein/dev/elasticsearch/elasticsearch-1.4.1/config/analysis > > the YML files are in the 'config' directory. > > On Thursday, January 22, 2015 at 3:37:39 PM UTC-8, Mark Walkom wrote: > > > The path needs to be relative to the config home for ES. > > > > Take a look at > > [Elasticsearch Platform — Find real-time answers at scale | Elastic](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/setup-dir-layout.html#default-paths) > > for where that would be on your installation. > > > > On 23 January 2015 at 08:45, james rubinstein [rubinste...@gmail.com](mailto:rubinste...@gmail.com) > > wrote: > > > > > Also, I tried this: > > > > > > curl -XPUT 'localhost:9200/test/\_settings' -d ' > > > > > > > { > > > > > > > ``` > > > > "index" : { > > > > > > > > ``` > > > > > > > ``` > > > > "analysis" : { > > > > > > > > ``` > > > > > > > ``` > > > > "analyzer" : { > > > > > > > > ``` > > > > > > > ``` > > > > "synonym" : { > > > > > > > > ``` > > > > > > > ``` > > > > "tokenizer" : "whitespace", > > > > > > > > ``` > > > > > > > ``` > > > > "filter" : ["synonym"] > > > > > > > > ``` > > > > > > > ``` > > > > } > > > > > > > > ``` > > > > > > > ``` > > > > }, > > > > > > > > ``` > > > > > > > ``` > > > > "filter" : { > > > > > > > > ``` > > > > > > > ``` > > > > "synonym" : { > > > > > > > > ``` > > > > > > > ``` > > > > "type" : "synonym", > > > > > > > > ``` > > > > > > > ``` > > > > "synonyms_path" : "analysis/synonym.txt" > > > > > > > > ``` > > > > > > > ``` > > > > } > > > > > > > > ``` > > > > > > > ``` > > > > } > > > > > > > > ``` > > > > > > > ``` > > > > } > > > > > > > > ``` > > > > > > > ``` > > > > } > > > > > > > > ``` > > > > > > > }' > > > > > > Which gives the response : {"acknowledged":true} , but it still didn't > > > change the outcome when querying > > > > > > On Thursday, January 22, 2015 at 12:57:51 PM UTC-8, james rubinstein > > > wrote: > > > > > > > Hi all, > > > > I'm new to using ES, but have so far found the process quite intuitive. > > > > I've installed ES, set up an index, indexed a bunch of JSON documents, and > > > > I can search them. Hooray! > > > > However, I want to start using synonyms for a few queries. I'd like to > > > > do this at query time using a synonym file. How can I install the synonym > > > > file and have ES read it? > > > > I'm using elasticsearch-1.4.1 on Mac OSX locally. > > > > > > > > I've read through the docs > > > > [http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html) but > > > > I still don't understand what to do because I'm still not seeing queries > > > > that use the synonym I've defined. > > > > > > > > POST /test/\_settings > > > > { > > > > "index" : { > > > > "analysis" : { > > > > "analyzer" : { > > > > "synonym" : { > > > > "tokenizer" : "whitespace", > > > > "filter" : ["synonym"] > > > > } > > > > }, > > > > "filter" : { > > > > "synonym" : { > > > > "type" : "synonym", > > > > "synonyms\_path" : "analysis/synonym.txt" > > > > } > > > > } > > > > } > > > > } > > > > } > > > > > > > > My synonym file has one line: > > > > > > > > "clementine =\> clementine,mandarin,orange,citrus" > > > > > > > > When I search for "Clementine" on my index I get 3 results, searching > > > > for "Orange" gets me 66. > > > > > > > > Thanks, > > > > JR > > > > > > > > -- > > > > You received this message because you are subscribed to the Google > > > > Groups "elasticsearch" group. > > > > To unsubscribe from this group and stop receiving emails from it, send > > > > an email to [elasticsearc...@googlegroups.com](mailto:elasticsearc...@googlegroups.com). > > > > To view this discussion on the web visit > > > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com) > > > > [https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm\_medium=email&utm\_source=footer](https://groups.google.com/d/msgid/elasticsearch/a887f420-b04b-4d5d-80aa-14c120fb9da3%40googlegroups.com?utm_medium=email&utm_source=footer) > > > > . > > > > > > For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). -- You received this message because you are subscribed to the Google Groups "elasticsearch" group. To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com). To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/aadf03af-02f1-41f9-b6fc-f8963efb25c1%40googlegroups.com](https://groups.google.com/d/msgid/elasticsearch/aadf03af-02f1-41f9-b6fc-f8963efb25c1%40googlegroups.com). For more options, visit [https://groups.google.com/d/optout](https://groups.google.com/d/optout). ---
**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\ **Post date:** [July 6, 2017, 12:37am UTC](https://discuss.elastic.co/t/need-some-n00b-help-how-do-i-install-and-set-up-synonyms-file/21785/6 "2017-07-06T00:37:04Z")