The Error
You are uploading or saving configuration files and Solr throws this:
Error loading class 'solr.ICUCollationField'
This means your schema references a special feature called ICU (International Components for Unicode), but the ICU library is not enabled on your server yet.
What Is ICU? (The Simple Version)
Imagine you have a list of names from all over the world — German names with umlauts (Muller vs Muller), French names with accents (Rene vs Rene), Chinese characters, Arabic text. Normal sorting puts them in weird, unexpected orders because computers sort by raw byte values, not by how humans actually read.
ICU teaches Solr how different languages actually work — how to sort them, compare them, and handle their special characters correctly. It is like giving Solr a language tutor for every language on Earth.
How to Fix It
The fix is simple: contact Opensolr Support and ask us to enable the ICU library on your server.
- Contact Opensolr Support
- Email: support@opensolr.com
We will enable ICU for your server, and the error will disappear. No changes needed on your side — just reload your Opensolr Index after we confirm it is done.
How to Check If This Is Your Error
If you are not sure what error you are dealing with, check your Error Logs:
- Open your Opensolr Index Control Panel
- Click the Error Log button
- Look for messages mentioning
ICUCollationFieldorICU
If you see ICU-related errors, that confirms you need the library enabled.
When Do You Need ICU?
| Use Case | Need ICU? |
|---|---|
| Sorting names in multiple languages | Yes |
| Case-insensitive collation | Yes |
| Unicode normalization (accents, umlauts) | Yes |
| Basic English-only text search | No |
| Simple numeric/date sorting | No |
| Drupal with multilingual content | Often yes |
Need ICU enabled? Just reach out to us at support@opensolr.com — it takes us minutes to flip the switch.