Skip to content

datastoreitem

Custom field type

All field types

A reference to a Datastore Item chosen by an editor.

Written as
"Type": "datastoreitem"
Valid on
Template fields, Datastore schema, and custom site settings
List form
datastoreitemlist — stores an array and accepts the same filters. It has no page of its own.
Validators
This type carries no validators.
Default value
The name of a Datastore Item, or Type:Name for a polymorphic reference.

Picker filters

Constrain which objects the editor offers. Every picker also accepts Exclude.

  • HasUrl
  • IncludeInSearch
  • SiteDomainGUID
  • TemplateGUID
  • FolderGUID
  • TagGUID
  • AuthorGUID
  • DatastoreGUID
  • DatastoreType
  • Query

Notes

A single picker carries no validators. Its datastoreitemlist variant does, and accepts minitems and maxitems to bound how many objects an editor may choose.

Query filters the picker's candidate set with a QueryPhrase object: Type, FieldID, Value, Invert, Conditions.
Type is one of exists, eq, neq, gt, gte, lt, lte, contains, like, and, or.
FieldID names the field being tested; required for every Type except and/or.
Value is the comparison value as a string; omitted when Type is exists, required otherwise.
Invert is a boolean; true negates the result. Omit it (or leave it false) for a normal match.
Conditions is a list of nested QueryPhrase objects; present only when Type is and or or, and FieldID/Value are omitted at that level, to build compound queries.

Verified against QueryPhrase.cs in _Marketpath.CMSBase (read-only checkout). Not verified: which FieldIDs are legal (built-in properties vs. custom FieldIDs only) and how Query is evaluated against candidates, since that logic lives outside this checkout. No import baseline exercises Query.