The Content Index powers Confluence's search functionality and is also used for a number of related functions such as building email threads in the mail archive, the Space Activity feature and lists of recently-updated content. The Gliffy Plugin also uses the index for some functionality.

For reasons of efficiency, content is not immediately added to the index. New and modified Confluence content is first placed in a queue, and the queue is processed once every minute (by default).

On this page:

Viewing the Content Index Summary

To see information about your Confluence instance's content indexing,

  1. Click 'Content Indexing' under the heading 'Administration' in the left-hand panel.

Screenshot: Index summary



You can ignore the line which says 'Index optimised: NO'. Confluence optimises the index automatically twice a day. The optimised status flag as shown above was really only useful in older versions of Confluence where index optimisation had to happen more frequently due to the type of index format we were using. We'll probably remove this indicator in the next release of Confluence.

Rebuilding the Content Index

The index is maintained automatically, but you may need to rebuild it manually under circumstances such as these:

To rebuild the content index,

  1. Click 'Content Indexing' under the heading 'Administration' in the left-hand panel.
  2. Click 'Rebuild Search Index'.

Screenshot: Content Indexing

Slow Reindexing

Does the reindexing take a long time to complete? The length of time depends on the following factors:

It may help to increase the heap memory allocation of Confluence by following the instructions in the JIRA documentation.

If you are running an older version of Confluence and find that the index rebuild is not progressing, you may need to shut down Confluence, and restart it with the following Java system property set: bucket.indexing.threads.fixed=1. This will cause the re-indexing to happen in a single thread and be much more stable (but slower).

Viewing the Index Browser

You can access the Lucene index browser used with Confluence, to see if the required documents have been added to the index.

To view the index browser,

  1. Open a browser window.
  2. Log in to Confluence.
  3. Type the following into the browser address bar: <Confluence location>/admin/indexbrowser.jsp.
    For example:
    http://localhost:8080/admin/indexbrowser.jsp
    
  4. You will be asked "Which index would you like to browse?"
  5. Type in the path of your index directory. By default, this is located at <Confluence Home directory/index>.
    For example, c:\confluence\data\index.
  6. You should see a list of indexed file names.

Screenshot: Index Browser

More Hints and Tips

RELATED TOPICS

administrators guide home