đź§© Using the AutoPhrase TokenFilter JAR in Opensolr
The AutoPhrase TokenFilter is a powerful Solr plugin that helps you recognize and index multi-word expressions as single tokens (think: "New York City" as one unit, not three). This can significantly improve the quality of search, autocomplete, and analytics.
⚡️ Is It Enabled by Default?
Not on all Opensolr environments!
If you're trying to use the AutoPhraseTokenFilterFactory and see errors like:
Plugin not found: solr.AutoPhraseTokenFilterFactory
...then the jar isn't active on your server (yet).
🛠️ What To Do?
-
Contact Us
Simply send us a request and we'll install the AutoPhrase library (or pretty much any other custom Solr plugin) for you. -
How to Request a Plugin
- Follow the step-by-step guide: How do I add a lib/jar file?
- Let us know which version of Solr you're using (the right jar version matters!).
- Optionally, send the JAR file directly if it's a custom or non-public library.
-
After Installation
- Once the plugin is in place, add the appropriate
<filter class="solr.AutoPhraseTokenFilterFactory" ... />element to your field type inschema.xml. - Reload your core to activate the new filter.
- Don't forget to update your schema or config if needed—AutoPhrase sometimes requires its own config files or phrase lists.
- Once the plugin is in place, add the appropriate
🚨 Gotchas & Tips
- Version Compatibility: Always use a plugin version that matches your Solr version.
- Security: Opensolr reviews all uploaded JARs for security reasons—public/official plugins are easier/faster to approve!
- Performance: Heavy custom token filters (like AutoPhrase) can impact indexing speed. Test with your real data!
🔍 Learn More
Questions? Contact Opensolr Support — we’re happy to help!
(If you’re a plugin power user, give us a heads up and we’ll have your Solr instance doing backflips in no time. 🕺)

