is it possible to have multi word synonyms

Yes we do support multi word synonyms.

i mean like mapping words separated by spaces to each other, eg, “black hat” -> “dark cap”, i wasnt able to achieve this, in my testing “black hat” ended up mapping to “dark” and “cap” separately

Hmm no this should work. Can you share a small reproducible example where it doesn't?

I’m running into the same issue. I created an example synonym (multi-way):

billy corgan, lead singer,  frontman

and if you search for ‘frontman’ it will correctly come up with ‘billy corgan’ but it will also match ‘lead’ in an irrelevant document. This happens on

0.24.1.rc10

and I can confirm it also happens on

0.25.1

.