﻿---
title: Add a preferred data tier to a deployment
description: In an Elasticsearch deployment, an index and its shards can be allocated to data tiers using routing and allocation settings. To allow indices to be allocated,...
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4539/troubleshoot/elasticsearch/add-tier
products:
  - Elasticsearch
---

# Add a preferred data tier to a deployment
In an Elasticsearch deployment, an index and its shards can be allocated to [data tiers](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4539/manage-data/lifecycle/data-tiers) using routing and allocation settings.
To allow indices to be allocated, follow these steps:
1. [Determine which tiers](#determine-target-tier) an index's shards can be allocated to.
2. [Resize your deployment](#resize-your-deployment).


## Determine the target tier

You can run the following step using either [API console](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4539/explore-analyze/query-filter/tools/console) or direct [Elasticsearch API](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/rest-apis) calls.
To determine which tiers an index's shards can be allocated to, use the [get index setting](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-get-settings) API to retrieve the configured value for the `index.routing.allocation.include._tier_preference` setting:
```json
```

The response looks like this:
```json
{
  "my-index-000001": {
    "settings": {
      "index.routing.allocation.include._tier_preference": "data_warm,data_hot" 
    }
  }
}
```


## Resize your deployment

<applies-switch>
  <applies-item title="{ ess:, ece: }">
    To enable a new tier in your Elastic Cloud Hosted deployment, you edit the deployment topology to add a new data tier.
    1. In Kibana, open your deployment’s navigation menu (placed under the Elastic logo in the upper left corner) and go to **Manage this deployment**.
    2. From the right hand side, click to expand the **Manage** dropdown button and select **Edit deployment** from the list of options.
    3. On the **Edit** page, click on **+ Add Capacity** for the tier you identified you need to enable in your deployment. Choose the desired size and availability zones for the new tier.
    4. Navigate to the bottom of the page and click the **Save** button.
  </applies-item>

  <applies-item title="{ self: }">
    Add more nodes to your Elasticsearch cluster and assign the index’s target tier [node role](/elastic/docs-content/pull/4539/manage-data/lifecycle/data-tiers#configure-data-tiers-on-premise) to the new nodes, by adjusting the configuration in `elasticsearch.yml`.
  </applies-item>

  <applies-item title="{ eck: }">
    Add more nodes to your Elasticsearch cluster and assign the index’s target tier [node role](/elastic/docs-content/pull/4539/deploy-manage/distributed-architecture/clusters-nodes-shards/node-roles#change-node-role) to the new nodes, by adjusting the [node configuration](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4539/deploy-manage/deploy/cloud-on-k8s/node-configuration) in the `spec` section of your Elasticsearch resource manifest.
  </applies-item>
</applies-switch>