Skip to main content

How to add a custom Search Attribute to a Cluster using tctl


The Temporal tctl documentation covers version 1.16 of the Temporal CLI.

Use the following command to add a custom Search Attribute to your Temporal Cluster.

tctl admin cluster add-search-attributes --name <SearchAttributeName> --type <SearchAttributeValueType>

Search Attribute names are case sensitive.

The possible values for --type are listed here.


Due to Elasticsearch limitations, you can only add new custom Search Attributes. You can't rename or remove existing Search Attributes.

Local testing

If you are adding custom Search Attributes to a Cluster running from the docker-compose-es.yml file in the temporalio/docker-compose repo, make sure to increase the Docker memory to more than 6 GB.