Configure metadata indexing strategies in Scaffolding
With Scaffolding 9.2.10 and later, administrators can control how metadata is indexed. This is useful for large Confluence instances and environments that use OpenSearch because it can help prevent indexing errors and improve search performance.
Use this guide to choose and apply the indexing strategy that matches your environment.
Understand indexing options
Scaffolding offers two strategies for metadata indexing. Choose the strategy based on your Confluence deployment type and metadata usage.
Strategy | Best for | How it works |
Standard indexing (Lucene) | Standard Confluence environments with moderate metadata usage. | Indexes every metadata field individually. This is the default setting. |
Optimized indexing (OpenSearch) | Large-scale metadata usage or OpenSearch deployments. | Stores metadata as |
When to switch to optimized indexing
Consider switching to optimized indexing if you see the following error in your logs:
Limit of total fields [1000] has been exceeded
This error occurs because OpenSearch has a default limit on the number of unique fields it can index. The optimized strategy helps avoid this issue by grouping metadata together.
Change the indexing strategy
To update the indexing strategy:
Log in as a Confluence administrator and go to General Configuration.
In the left sidebar, find Scaffolding Forms & Templates and select the configuration page.
Find Metadata Indexing Strategy and select Standard or Optimized.
Select Save.
Reindex Confluence
Changing the indexing strategy doesn't affect existing data until you perform a full reindex.
Go to General Configuration > Content Indexing.
Select Rebuild to perform a full reindex of your Confluence site.
After the reindex is complete, Scaffolding metadata is searchable using the new indexing logic.
Need help? Contact Support.