[id="change-index-name"]
== Change the index name

ifndef::no_ilm[]
TIP: If you're sending events to a cluster that supports index lifecycle
management, you need to change the index name in the ILM policy.
See <<ilm>> to learn how to change it.
endif::no_ilm[]

{beatname_uc} uses time series indices, by default, when index lifecycle
management is disabled or unsupported. The indices are named
+{beatname_lc}-{version}-yyyy.MM.dd+, where `yyyy.MM.dd` is the date when the
events were indexed. To use a different name, set the
<<index-option-es,`index`>> option in the {es} output. The value that
you specify should include the root name of the index plus version and date
information. You also need to configure the `setup.template.name` and
`setup.template.pattern` options to match the new name. For example:

["source","sh",subs="attributes,callouts"]
-----
output.elasticsearch.index: "customname-%{[{beat_version_key}]}-%{+yyyy.MM.dd}"
setup.template.name: "customname"
setup.template.pattern: "customname-*"
-----

ifndef::no_ilm[]
WARNING: If <<ilm,index lifecycle management>> is enabled (which is typically the default), `setup.template.name` and `setup.template.pattern` are ignored.
endif::no_ilm[]

ifndef::no_dashboards[]
If you're using pre-built Kibana dashboards, also set the
`setup.dashboards.index` option. For example: 

[source, yaml]
----
setup.dashboards.index: "customname-*"
----
endif::no_dashboards[]

For a full list of template setup options, see <<configuration-template>>.

ifdef::no_dashboards[]
Remember to change the index name when you load dashboards via the Kibana UI.
endif::no_dashboards[]
