From 675c4d6ddb416d9f72ae0ffb768636229f2c0262 Mon Sep 17 00:00:00 2001
From: Karen Metts <karen.metts@elastic.co>
Date: Mon, 23 Mar 2026 18:02:34 -0400
Subject: [PATCH 1/2] Doc: Use index with/out datamatch OR alias/datastream

---
 docs/index.asciidoc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/index.asciidoc b/docs/index.asciidoc
index 3611c04b4..c89acede2 100644
--- a/docs/index.asciidoc
+++ b/docs/index.asciidoc
@@ -139,6 +139,15 @@ output {
 
 ==== Writing to different indices: best practices
 
+.Important considerations for time-based routing
+****
+Time-based routing in this plugin follows *one* model at a time. _Do not_ mix models.
+
+* *Data streams.* Use <<plugins-{type}s-{plugin}-data_stream,`data_stream`>> and related settings.
+* *Index lifecycle management (ILM) rollover.* The value you set using <<plugins-{type}s-{plugin}-ilm_pattern,`ilm_pattern`>> is used for naming, and should align with {ref}/indices-rollover-index.html#_using_date_math_with_the_rollover_api[Elasticsearch rollover naming].
+* *Explicit index names.* Use the <<plugins-{type}s-{plugin}-index,`index`>> setting and `%{+...}` syntax for daily (or other) rotation. 
+****
+
 NOTE: You cannot use dynamic variable substitution when `ilm_enabled` is `true` 
 and when using `ilm_rollover_alias`.
 

From 26f77b2290796271c448ba263e5e8bc9c3d88448 Mon Sep 17 00:00:00 2001
From: Karen Metts <karen.metts@elastic.co>
Date: Mon, 23 Mar 2026 18:12:41 -0400
Subject: [PATCH 2/2] Bump to v12.1.3

---
 CHANGELOG.md                          | 3 +++
 logstash-output-elasticsearch.gemspec | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f63676add..d1d0c0276 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,6 @@
+## 12.1.3
+ - [DOC] Update docs to present time-based routing models, and clarify that only one model can be in use at a time [#1252](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1252)
+
 ## 12.1.2
  - Fix: replace deprecated `File.exists?` with `File.exist?` for Ruby 3.4 (JRuby 10) compatibility [#1238](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1238)
 
diff --git a/logstash-output-elasticsearch.gemspec b/logstash-output-elasticsearch.gemspec
index a9f5c6adf..8e59f19af 100644
--- a/logstash-output-elasticsearch.gemspec
+++ b/logstash-output-elasticsearch.gemspec
@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name            = 'logstash-output-elasticsearch'
-  s.version         = '12.1.2'
+  s.version         = '12.1.3'
   s.licenses        = ['apache-2.0']
   s.summary         = "Stores logs in Elasticsearch"
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"