Lucene 10.3.1 upgrade in Jira 12

Hello, Developer Community!

As we prepare for the release of Jira 12, we’re upgrading the Lucene search library from version 7.3 to 10.3.1. This upgrade brings significant performance improvements and bug fixes, but it also introduces breaking changes that may affect your apps and custom indexers.

What you need to know:

  • Full reindex required: Upgrading to Jira 12 triggers an automated foreground reindex.
  • API removals: We’ve removed obsolete methods from the Jira API and jira-lucene-dmz.jar.
  • Custom indexers: If you override indexFields, you must now use FieldValueCollector.
  • Configuration: Several merge policy settings (e.g., maxmergeatonceexplicit) are now obsolete.
  • Label ordering: We fixed a bug where reindexed issues were incorrectly boosted in results.

View the full list of changes

Please let us know if you have any questions or feedback in the comments below!