How to restore or preserve Site Statistics

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

You've enabled the Viewing Site Statistics to track global, space, and site activity and you'd like to preserve or restore them.

Note that this feature will be removed in Confluence 8.0. For more information, see CONFSERVER-57612 - Plans to end support for Usage Stats

Solution

The usage data is stored in its own Lucene index which is located in <confluence-home>/index/plugin/usage. To restore the data you'll need a copy of it, e.g. from a backup or a production instance:

  1. Stop Confluence

  2. Copy the <confluence-home>/index/plugin/usage from the backup to the production instance

    1. If you're copying from a production instance, ensure that instance is stopped as well

  3. Go to

    (Auto-migrated image: description temporarily unavailable)

    > General Config > Content Indexing > Rebuild

You should now be able to see the restored site statistics

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.