New Troubleshooting Guide: The Solr "Document Contains at Least One Immense Term" Error

· Documentation · New Feature · All updates

There is now a troubleshooting guide for the Solr "immense term" error — the one that reads "Document contains at least one immense term" and stops an indexing run.

01 Why it happens

The guide walks through the cause: untokenized field types treat your entire field value as one giant token, and once that token exceeds Solr's maximum term length, the document is rejected.

Tokenized field many small terms Untokenized field one term, longer than the maximum length reject
One field value, one token: the whole value has to fit inside Solr's term length limit.

02 How to fix it

The guide gives visual diagrams, code examples for all four common solutions, and a dedicated section for Drupal and Search API users, whose schemas hit this most often. You will find it under SOLR-Errors in the FAQ.

View the full changelog