diff --git a/docs/fields/overview.mdx b/docs/fields/overview.mdx index 763c47298b..40fb9953e5 100644 --- a/docs/fields/overview.mdx +++ b/docs/fields/overview.mdx @@ -70,7 +70,16 @@ In addition to being able to define access control on a document-level, you can ### Field names -Some fields use their `name` property as a unique identifier to store and retrieve from the database. `__v`, `salt`, and `hash` are all reserved field names which are sanitized from Payload's config and cannot be used. +All fields require a `name` property. This is the key that will be used to store and retrieve the field's value in the database. This property must be unique within the Collection, Global, or nested group that it is defined in. + +Payload reserves various field names for internal use. Using reserved field names will result in your field being sanitized from the config. + +The following field names are forbidden and cannot be used: + + - `__v` + - `salt` + - `hash` + - `file` ### Validation