diff --git a/libbeat/docs/template-config.asciidoc b/libbeat/docs/template-config.asciidoc
index 0ab1c35681ee..8338ed334672 100644
--- a/libbeat/docs/template-config.asciidoc
+++ b/libbeat/docs/template-config.asciidoc
@@ -69,6 +69,11 @@ setup.template.settings:
   index.number_of_replicas: 1
 ----------------------------------------------------------------------
 
+NOTE: If you want to use {stack-ov}/xpack-ccr.html[{ccr}] to replicate {beatname_uc}
+indices to another cluster, you will need to add additional template settings to
+{stack-ov}/ccr-requirements.html#ccr-overview-beats[enable soft deletes] on the
+underlying indices.
+
 *`setup.template.settings._source`*:: A dictionary of settings for the `_source` field. For the available settings,
 please see the Elasticsearch {elasticsearch}/mapping-source-field.html[reference].
 +