Update mapping

Introduced 1.0

If you want to update an index’s mappings to add or update field types after index creation, you can do so with the update mapping API operation.

Note that you cannot use this operation to update mappings that already map to existing data in the index. You must first create a new index with your desired mappings, and then use the reindex API operation to map all the documents from your old index to the new index. If you don’t want any downtime while reindexing your indices, you can use aliases.

Example

PUT /sample-index/_mapping
{
  "properties": {
    "age": {
      "type": "integer"
    },
    "occupation":{
      "type": "text"
    }
  }
}

Path and HTTP methods

PUT /<target-index>/_mapping

You can also use the update mapping operation to update multiple indices with one request.

PUT /<target-index1>,<target-index2>/_mapping

URL parameters

All update mapping parameters are optional.

Request body

The request body must contain properties, which has all of the mappings that you want to update.

{
  "properties":{
    "color":{
      "type": "text"
    },
    "year":{
      "type": "integer"
    }
  }
}

Response

{
    "acknowledged": true
}