Term vectors contain information about the terms produced by the analysis process, including:

  • a list of terms.
  • the position (or order) of each term.
  • the start and end character offsets mapping the term to its origin in the original string.

These term vectors can be stored so that they can be retrieved for a particular document.

The term_vector setting accepts:


No term vectors are stored. (default)


Just the terms in the field are stored.


Terms and positions are stored.


Terms and character offsets are stored.


Terms, positions, and character offsets are stored.

The fast vector highlighter requires with_positions_offsets. The term vectors API can retrieve whatever is stored.


Setting with_positions_offsets will double the size of a field’s index.

PUT my_index
  "mappings": {
    "_doc": {
      "properties": {
        "text": {
          "type":        "text",
          "term_vector": "with_positions_offsets"

PUT my_index/_doc/1
  "text": "Quick brown fox"

GET my_index/_search
  "query": {
    "match": {
      "text": "brown fox"
  "highlight": {
    "fields": {
      "text": {} 

The fast vector highlighter will be used by default for the text field because term vectors are enabled.