diff --git a/README.md b/README.md
index f7cb8d2..d72032a 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,7 @@ Searchkick provides sensible search defaults out of the box.  It handles:
 - special characters - `jalapenos` matches `jalapeños`
 - extra whitespace - `dishwasher` matches `dish washer`
 - misspellings - `zuchini` matches `zucchini`
+- custom synonyms - `qtip` matches `cotton swab`
 
 Simply use the `searchkick` analyzer.
 
@@ -36,6 +37,8 @@ Book.search do
 end
 ```
 
+**Note:** We recommend reindexing when changing synonyms for best results.
+
 ### Make Searches Better Over Time
 
 Use analytics on search conversions to improve results.
--
libgit2 0.21.0