Documentation for JIRA 4.3. Documentation for other versions of JIRA is available too.

In order to provide fast searching, JIRA creates an index of the text entered into issue fields. This index is stored on the file system, and updated whenever issue text is added or modified. It is sometimes necessary to regenerate this index manually; for instance if issues have been manually entered into the database, or the index has been lost or corrupted.

Indexing Administration

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Under the 'System' sub-menu on the left, click the 'Indexing' link.
  4. This page allows you to:
    • re-index your data — whenever you re-index data, JIRA will clear any existing indexes and re-index all the current data from scratch. This may take a few minutes, depending on how many issues you have, and users will be unable to access JIRA during this time.
    • optimise your indexes — by clicking the Optimise Indexes link to access this function.

Screenshot: Indexing JIRA

Choosing a custom Index Path:


If you upgraded JIRA with an XML backup from a JIRA version prior to 4.2 and used a custom directory for your index path, you can choose between using this custom directory (which cannot be edited) or the default directory for your index path location. However, once you switch to using the default directory, you can no longer choose the custom directory option.

(The default directory location is the caches/indexes subdirectory of the JIRA home directory.)



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.