Templates are still reported as out of date after the upgrade The template upgrade will be retried – How to solve this Elasticsearch error

Opster Team

Aug-23, Version: 6.8-8.9

Briefly, this error occurs when Elasticsearch templates are not updated correctly after an upgrade. This could be due to a variety of reasons such as incorrect template settings, version incompatibility, or issues with the upgrade process itself. To resolve this issue, you can try re-running the upgrade process, ensuring that the correct version of Elasticsearch is being used, or manually updating the templates to match the new version. Additionally, check for any errors in the Elasticsearch logs that might indicate what’s causing the templates to be out of date.

In addition we recommend you run the Elasticsearch Template Optimizer to fix problems in your data modeling.

It will analyze your templates to detect issues and improve search performance, reduce indexing bottlenecks and optimize storage utilization. The Template Optimizer is free and requires no installation.

Log Context

Log “Templates are still reported as out of date after the upgrade. The template upgrade will be retried.” classname is TemplateUpgradeService.java.
We extracted the following from Elasticsearch source code for those seeking an in-depth context :

                // report that changes are required; this might indicate a bug or that something
                // else tinkering with the templates during the upgrade.
                final Map upgradedTemplates = clusterService.state().getMetadata().getTemplates();
                final boolean changesRequired = calculateTemplateChanges(upgradedTemplates).isPresent();
                if (changesRequired) {
                    logger.warn("Templates are still reported as out of date after the upgrade. The template upgrade will be retried.");
            } finally {
                final int noMoreUpgrades = upgradesInProgress.decrementAndGet();
                assert noMoreUpgrades == 0;


How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?