elastic · cotti · Sep 25, 2025 · Sep 3, 2025 · Sep 3, 2025 · Sep 3, 2025
@@ -1,82 +1,228 @@
 #############################################
 # This file defines the legacy URL mappings for the documentation site.
 # It maps current documentation pages to older versions to ensure users can find the content they need.
-# TODO: Refactor the model, for now we just use the first element as current version
+# Upon creation of version selection dropdowns, this data is combined with the current version of its product.
 #############################################
 
-stack: &stack [ '9.0+', '8.19', '8.18', '8.17', '8.16', '8.15', '8.14', '8.13', '8.12', '8.11', '8.10', '8.9', '8.8', '8.7', '8.6', '8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '7.17' ]
+stack: &stack [ '8.19', '8.18', '8.17', '8.16', '8.15', '8.14', '8.13', '8.12', '8.11', '8.10', '8.9', '8.8', '8.7', '8.6', '8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '7.17' ]
 
 mappings:
-  en/apm/agent/android/: [ '1.2.0' , '0.x' ]
-  en/apm/agent/dotnet/: [ '1.34.0' ]
-  en/apm/agent/go/: [ '2.7.1', '1.x', '0.5' ]
-  en/apm/agent/java/: ['1.54.0', '0.7', '0.6']
-  en/apm/agent/nodejs/: [ '4.x', '3.x', '2.x', '1.x' ]
-  en/apm/agent/php/: [ '1.15.1', '1.x' ]
-  en/apm/agent/python/: [ '6.24.0', '5.x', '4.x', '3.x', '2.x', '1.x' ]
-  en/apm/agent/ruby/: [ '4.8.0', '3.x', '2.x', '1.x' ]
-  en/apm/agent/rum-js/: [ '5.17.0', '4.x', '3.x', '2.x', '1.x', '0.x' ]
-  en/apm/agent/swift/: [ '1.2.1', '0.x' ]
-  en/apm/attacher/: [ '1.1.3' ]
-  en/apm/lambda/: [ '1.5.8' ]
-  en/beats/auditbeat/: *stack
-  en/beats/devguide/: *stack
-  en/beats/filebeat/: *stack
-  en/beats/functionbeat/: *stack
-  en/beats/heartbeat/: *stack
-  en/beats/journalbeat/: *stack
-  en/beats/libbeat/: *stack
-  en/beats/loggingplugin/: *stack
-  en/beats/metricbeat/: *stack
-  en/beats/packetbeat/: *stack
-  en/beats/topbeat/: *stack
-  en/beats/winlogbeat/: *stack
-  en/cloud-heroku/: []
-  en/cloud-on-k8s/: [ '3.0+', '2.16', '2.15', '2.14', '2.13', '2.12', '2.11', '2.10', '2.9', '2.8', '2.7', '2.6', '2.5', '2.4', '2.3', '2.2', '2.1', '2.0', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
-  en/cloud/: []
-  en/cloud-enterprise/: [ '4.0', '3.8', '3.7', '3.6', '3.5', '3.4', '3.3', '3.2', '3.1', '3.0', '2.13', '2.12', '2.11', '2.10', '2.9', '2.8', '2.7', '2.6', '2.5', '2.4', '2.3', '2.2', '2.1', '2.0', '1.1', '1.0' ]
-  en/ecctl/: [ '1.14+', '1.13', '1.12', '1.11', '1.10', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
-  en/ecs-logging/: []
-  en/ecs-logging/dotnet/: [ '8.18.1' ]
-  en/ecs-logging/go-logrus/: [ '1.0.0' ]
-  en/ecs-logging/go-zap/: [ '1.0.3' ]
-  en/ecs-logging/go-zerolog/: [ '0.2.0' ]
-  en/ecs-logging/java/: [ '1.7.0', '0.x' ]
-  en/ecs-logging/nodejs/: [ '1.5.3' ]
-  en/ecs-logging/overview/: []
-  en/ecs-logging/php/: [ '2.0.0' ]
-  en/ecs-logging/python/: [ '2.2.0' ]
-  en/ecs-logging/ruby/: ['1.0.0']
-  en/ecs/: [ '9.0+', '8.18', '8.17', '8.16', '8.15', '8.14', '8.13', '8.12', '8.11', '8.10', '8.9', '8.8', '8.7', '8.6', '8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '1.12', '1.11', '1.10', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
-  en/elastic-stack-glossary/: []
-  en/elastic-stack/: *stack
-  en/elasticsearch/client/curator/: [ '8.0.21', '7.0', '6.0', '5.8', '5.7', '5.6', '5.5', '5.4', '5.3', '5.2', '5.1', '5.0', '4.3', '4.2', '4.1', '4.0', '3.5', '3.4', '3.3' ]
-  en/elasticsearch/client/eland/: [ '9.0.1' ]
-  en/elasticsearch/client/go-api/: *stack
-  en/elasticsearch/client/java-api-client/: *stack
-  en/elasticsearch/client/javascript-api/: *stack
-  en/elasticsearch/client/net-api/: *stack
-  en/elasticsearch/client/php-api/: *stack
-  en/elasticsearch/client/python-api/: *stack
-  en/elasticsearch/client/ruby-api/: *stack
-  en/elasticsearch/client/rust-api/: *stack
-  en/elasticsearch/hadoop/: *stack
-  en/elasticsearch/painless/: *stack
-  en/elasticsearch/plugins/: *stack
-  en/elasticsearch/reference/: *stack
-  en/esf/: ['1.20.1']
-  en/fleet/: *stack
-  en/ingest-overview/: []
-  en/ingest/: *stack
-  en/integrations-developer/: []
-  en/integrations/: []
-  en/kibana/: *stack
-  en/logstash-versioned-plugins/: []
-  en/logstash/: *stack
-  en/machine-learning/: *stack
-  en/observability/: *stack
-  en/reference-architectures/: []
-  en/search-ui/: ['1.24.0']
-  en/security/: *stack
-  en/serverless/: []
-  en/starting-with-the-elasticsearch-platform-and-its-solutions/: *stack
+  en/apm/agent/android/:
+    product: apm-agent-android
+    legacy_versions: [ '0.x' ]
+  en/apm/agent/dotnet/:
+    product: apm-agent-dotnet
+    legacy_versions: [ '1.33.0' ]
+  en/apm/agent/go/:
+    product: apm-agent-go
+    legacy_versions: [ '1.x', '0.5' ]
+  en/apm/agent/java/:
+    product: apm-agent-java
+    legacy_versions: [ '1.54.0', '0.7', '0.6']
+  en/apm/agent/nodejs/:
+    product: apm-agent-node
+    legacy_versions: [ '4.x', '3.x', '2.x', '1.x' ]
+  en/apm/agent/php/:
+    product: apm-agent-php
+    legacy_versions: [ '1.x' ]
+  en/apm/agent/python/:
+    product: apm-agent-python
+    legacy_versions: [ '5.x', '4.x', '3.x', '2.x', '1.x' ]
+  en/apm/agent/ruby/:
+    product: apm-agent-ruby
+    legacy_versions: [ '3.x', '2.x', '1.x' ]
+  en/apm/agent/rum-js/:
+    product: apm-agent-rum-js
+    legacy_versions: [ '4.x', '3.x', '2.x', '1.x', '0.x' ]
+  en/apm/agent/swift/:
+    product: apm-agent-ios
+    legacy_versions: [ '1.2.1', '0.x' ]
+  en/apm/attacher/:
+    product: apm-k8s-attacher
+    legacy_versions: []
+  en/apm/lambda/:
+    product: apm-aws-lambda
+    legacy_versions: []
+  en/beats/auditbeat/:
+    product: auditbeat
+    legacy_versions: *stack
+  en/beats/devguide/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/filebeat/:
+    product: filebeat
+    legacy_versions: *stack
+  en/beats/functionbeat/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/heartbeat/:
+    product: heartbeat
+    legacy_versions: *stack
+  en/beats/journalbeat/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/libbeat/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/loggingplugin/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/metricbeat/:
+    product: metricbeat
+    legacy_versions: *stack
+  en/beats/packetbeat/:
+    product: packetbeat
+    legacy_versions: *stack
+  en/beats/topbeat/:
+    product: beats
+    legacy_versions: *stack
+  en/beats/winlogbeat/:
+    product: winlogbeat
+    legacy_versions: *stack
+  en/cloud-heroku/:
+    product: cloud-hosted
+    legacy_versions: []
+  en/cloud-on-k8s/:
+    product: cloud-kubernetes
+    legacy_versions: [ '3.0+', '2.16', '2.15', '2.14', '2.13', '2.12', '2.11', '2.10', '2.9', '2.8', '2.7', '2.6', '2.5', '2.4', '2.3', '2.2', '2.1', '2.0', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
+  en/cloud/:
+    product: cloud-hosted
+    legacy_versions: []
+  en/cloud-enterprise/:
+    product: cloud-enterprise
+    legacy_versions: [ '4.0', '3.8', '3.7', '3.6', '3.5', '3.4', '3.3', '3.2', '3.1', '3.0', '2.13', '2.12', '2.11', '2.10', '2.9', '2.8', '2.7', '2.6', '2.5', '2.4', '2.3', '2.2', '2.1', '2.0', '1.1', '1.0' ]
+  en/ecctl/:
+    product: cloud-control-ecctl
+    legacy_versions: [ '1.14+', '1.13', '1.12', '1.11', '1.10', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
+  en/ecs-logging/:
+    product: ecs-logging
+    legacy_versions: []
+  en/ecs-logging/dotnet/:
+    product: ecs-dotnet
+    legacy_versions: []
+  en/ecs-logging/go-logrus/:
+    product: ecs-logging-go-logrus
+    legacy_versions: []
+  en/ecs-logging/go-zap/:
+    product: ecs-logging-go-zap
+    legacy_versions: []
+  en/ecs-logging/go-zerolog/:
+    product: ecs-logging-go-zerolog
+    legacy_versions: []
+  en/ecs-logging/java/:
+    product: ecs-logging-java
+    legacy_versions: ['0.x']
+  en/ecs-logging/nodejs/:
+    product: ecs-logging-nodejs
+    legacy_versions: []
+  en/ecs-logging/overview/:
+    product: ecs-logging
+    legacy_versions: []
+  en/ecs-logging/php/:
+    product: ecs-logging-php
+    legacy_versions: []
+  en/ecs-logging/python/:
+    product: ecs-logging-python
+    legacy_versions: [ '2.2.0' ]
+  en/ecs-logging/ruby/:
+    product: ecs-logging-ruby
+    legacy_versions: []
+  en/ecs/:
+    product: ecs
+    legacy_versions: [ '8.18', '8.17', '8.16', '8.15', '8.14', '8.13', '8.12', '8.11', '8.10', '8.9', '8.8', '8.7', '8.6', '8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '1.12', '1.11', '1.10', '1.9', '1.8', '1.7', '1.6', '1.5', '1.4', '1.3', '1.2', '1.1', '1.0' ]
+  en/elastic-stack-glossary/:
+    product: elastic-stack
+    legacy_versions: []
+  en/elastic-stack/:
+    product: elastic-stack
+    legacy_versions: *stack
+  en/elasticsearch/client/curator/:
+    product: curator
+    legacy_versions: [ '8.0.21', '7.0', '6.0', '5.8', '5.7', '5.6', '5.5', '5.4', '5.3', '5.2', '5.1', '5.0', '4.3', '4.2', '4.1', '4.0', '3.5', '3.4', '3.3' ]
+  en/elasticsearch/client/eland/:
+    product: eland
+    legacy_versions: []
+  en/elasticsearch/client/go-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/java-api-client/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/javascript-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/net-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/php-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/python-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/ruby-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/client/rust-api/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/hadoop/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/painless/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/plugins/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/elasticsearch/reference/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/esf/:
+    product: elastic-serverless-forwarder
+    legacy_versions: []
+  en/fleet/:
+    product: elastic-agent
+    legacy_versions: *stack
+  en/ingest-overview/:
+    product: elasticsearch
+    legacy_versions: []
+  en/ingest/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/integrations-developer/:
+    product: integrations
+    legacy_versions: []
+  en/integrations/:
+    product: integrations
+    legacy_versions: []
+  en/kibana/:
+    product: kibana
+    legacy_versions: *stack
+  en/logstash-versioned-plugins/:
+    product: logstash
+    legacy_versions: []
+  en/logstash/:
+    product: logstash
+    legacy_versions: *stack
+  en/machine-learning/:
+    product: elasticsearch
+    legacy_versions: *stack
+  en/observability/:
+    product: observability
+    legacy_versions: *stack
+  en/reference-architectures/:
+    product: elasticsearch
+    legacy_versions: []
+  en/search-ui/:
+    product: search-ui
+    legacy_versions: ['1.24.1', '1.24.0']
+  en/security/:
+    product: security
+    legacy_versions: *stack
+  en/serverless/:
+    product: cloud-serverless
+    legacy_versions: []
+  en/starting-with-the-elasticsearch-platform-and-its-solutions/:
+    product: elasticsearch
+    legacy_versions: *stack