Skip to content

Updating the index compatibility range with 9.x variables #4321

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yetanothertw merged 9 commits into from
Dec 16, 2025
Merged

Updating the index compatibility range with 9.x variables #4321

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
544a621
Updating the index compatibility range with 9.x variables
yetanothertw Dec 12, 2025
0d84d07
Fix variable
yetanothertw Dec 12, 2025
7d1eff0
Use the general {{version.stack}} variable
yetanothertw Dec 12, 2025
811600f
Swap columns for better 9.x visibility/prominence
yetanothertw Dec 15, 2025
13bb919
Update 8.18 -> 8.19 in column header
yetanothertw Dec 15, 2025
2b29548
Update deploy-manage/tools/snapshot-and-restore.md
yetanothertw Dec 15, 2025
6e729db
Merge branch 'main' into 3599-index-compatibility
yetanothertw Dec 15, 2025
cc4bcb9
Add row entry for 9 to 9 compatibility
yetanothertw Dec 15, 2025
7836f30
Merge branch 'main' into 3599-index-compatibility
yetanothertw Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 12 additions & 15 deletions deploy-manage/tools/snapshot-and-restore.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,7 @@ mapped_pages:
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-restoring-snapshots.html
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-snapshots.html
applies_to:
deployment:
eck:
ess:
ece:
self:
stack: all
products:
- id: elasticsearch
- id: cloud-hosted
Expand Down Expand Up @@ -152,16 +148,17 @@ You can’t restore a snapshot to an earlier version of {{es}}. For example, you

### Index compatibility

Any index you restore from a snapshot must also be compatible with the current cluster’s version. If you try to restore an index created in an incompatible version, the restore attempt will fail.

| Index creation version | 6.8 | 7.0–7.1 | 7.2–7.17 | 8.0–8.2 | 8.3–8.18 | 9.0 |
|------------------------|-----|---------|---------|---------|---------|-----|
| 5.0–5.6 | ✅ | ❌ | ❌ | ❌ | ✅ ^1^ | ✅ ^1^ |
| 6.0–6.7 | ✅ | ✅ | ✅ | ❌ | ✅ ^1^ | ✅ ^1^ |
| 6.8 | ✅ | ❌ | ✅ | ❌ | ✅ ^1^ | ✅ ^1^ |
| 7.0–7.1 | ❌ | ✅ | ✅ | ✅ | ✅ | ✅ ^1, 2^ |
| 7.2–7.17 | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ ^1, 2^ |
| 8.0–8.18 | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
Any index you restore from a snapshot must also be compatible with the current cluster’s version. If you try to restore an index created in an incompatible version, the restore attempt fails.

| Index creation version | {{version.stack.base}}–{{version.stack}} | 8.3–8.19 | 8.0–8.2 | 7.2–7.17 | 7.0–7.1 | 6.8 |
|------------------------------------------| ----------------------------------------- |----------|---------|----------|---------|-----|
| 5.0–5.6 | ✅ ^1^ | ✅ ^1^ | ❌ | ❌ | ❌ | ✅ |
| 6.0–6.7 | ✅ ^1^ | ✅ ^1^ | ❌ | ✅ | ✅ | ✅ |
| 6.8 | ✅ ^1^ | ✅ ^1^ | ❌ | ✅ | ❌ | ✅ |
| 7.0–7.1 | ✅ ^1, 2^ | ✅ | ✅ | ✅ | ✅ | ❌ |
| 7.2–7.17 | ✅ ^1, 2^ | ✅ | ✅ | ✅ | ❌ | ❌ |
| 8.0–8.19 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| {{version.stack.base}}–{{version.stack}} | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |

^1^ $$$footnote-1$$$ Supported with [archive indices](/deploy-manage/upgrade/deployment-or-cluster/reading-indices-from-older-elasticsearch-versions.md).

Expand Down
Loading