store

By default, field values are indexed to make them searchable, but they are not stored. This means that the field can be queried, but the original field value cannot be retrieved.

Usually this doesn’t matter. The field value is already part of the _source field, which is stored by default. If you only want to retrieve the value of a single field or of a few fields, instead of the whole _source, then this can be achieved with source filtering.

In certain situations it can make sense to store a field. For instance, if you have a document with a title, a date, and a very large content field, you may want to retrieve just the title and the date without having to extract those fields from a large _source field:

  1. PUT my-index-000001
  2. {
  3.   "mappings": {
  4.     "properties": {
  5.       "title": {
  6.         "type": "text",
  7.         "store": true 
  8.       },
  9.       "date": {
  10.         "type": "date",
  11.         "store": true 
  12.       },
  13.       "content": {
  14.         "type": "text"
  15.       }
  16.     }
  17.   }
  18. }
  20. PUT my-index-000001/_doc/1
  21. {
  22.   "title":   "Some short title",
  23.   "date":    "2015-01-01",
  24.   "content": "A very long content field..."
  25. }
  27. GET my-index-000001/_search
  28. {
  29.   "stored_fields": [ "title", "date" ] 
  30. }

The title and date fields are stored.

This request will retrieve the values of the title and date fields.

Stored fields returned as arrays

For consistency, stored fields are always returned as an array because there is no way of knowing if the original field value was a single value, multiple values, or an empty array.

If you need the original value, you should retrieve it from the _source field instead.

Another situation where it can make sense to make a field stored is for those that don’t appear in the _source field (such as copy_to fields).