diff --git a/learn/getting_started/documents.mdx b/learn/getting_started/documents.mdx index c7464220f..d457c8565 100644 --- a/learn/getting_started/documents.mdx +++ b/learn/getting_started/documents.mdx @@ -24,13 +24,13 @@ Nothing will be shared between two indexes if they contain the exact same docume ## Fields -A field is a set of two data items linked together: an attribute and a value. Documents are made up of fields. +A **field** is a set of two data items linked together: an attribute and a value. Documents are made up of fields. -An **attribute** functions a bit like a variable in most programming languages. It is a name that allows you to store, access, and describe some data. +An **attribute** is a case-sensitive string that functions as a field's name and allows you to store, access, and describe data. -That data is the attribute's **value**. In the case of strings, a value **[can contain at most 65535 positions](/learn/resources/known_limitations#maximum-number-of-words-per-attribute)**. Words exceeding the 65535 position limit will be ignored. +That data is the field's **value**. Every field has a data type dictated by its value. Every value must be a valid [JSON data type](https://www.w3schools.com/js/js_json_datatypes.asp). -Every field has a data type dictated by its value. Every value must be a valid [JSON data type](https://www.w3schools.com/js/js_json_datatypes.asp). +If the value is a string, it **[can contain at most 65535 positions](/learn/resources/known_limitations#maximum-number-of-words-per-attribute)**. Words exceeding the 65535 position limit will be ignored. If a field contains an object, Meilisearch flattens it during indexing using dot notation and brings the object's keys and values to the root level of the document itself. This flattened object is only an intermediary representation—you will get the original structure upon search. You can read more about this in our [dedicated guide](/learn/engine/datatypes#objects).