Field Type
Resource that represents a field type definition. These types can be assigned to custom fields, permitting businesses to create unique and complex ways to model their profile data.
$idstring
$schemaconst
“https://schema.yext.com/config/km/field-type/v1" descriptionstring
Optional property describing the type.
descriptionTranslationarray
Translations of the description for different locale codes.
Each item of this array must be:
string Required
The locale code of the translation.
string Required
The value of the translation.
displayNamestring Required
Display name of the type.
displayNameTranslationarray
Translations of the displayName for different locale codes.
Each item of this array must be:
typeobject
Property that contains the subfields for this type.
object
A Struct type which contains a group of subfields that each have a unique subfield ID.
array of object Required
List of subfields of the struct type.
Must contain a minimum of 1 items
Each item of this array must be:
A subfield of the struct type.
string Required
The name of the subfield.
string Required
The display name of the subfield.
array
Translations of the displayName for different locale codes.
Each item of this array must be:
boolean Required
Flag that determines if this subfield is required.
string Required
The type ID of the subfield.
object
object
A Boolean (Yes/No) type.
object
A Date type.
object
A type describing a certain date.
Same definition as definitions_dateType_maxValueobject
A type describing a certain date.
Same definition as type_structType_property_items_type_dateType_minValueobject
A Decimal type.
string
string
object
A File type.
integer
Size of the file in bytes.
Value must be greater or equal to 0 and lesser or equal to 104857600
object
A MIME type filter.
array of object
The list of MIME types supported by the file type.
Each item of this array must be:
enum (of string)
Primary type of the file.
Must be one of:
- “UNKNOWN”
- “APPLICATION”
- “AUDIO”
- “FONT”
- “EXAMPLE”
- “IMAGE”
- “MESSAGE”
- “MODEL”
- “MULTIPART”
- “TEXT”
- “VIDEO”
string
Subtype of the file.
object
An Image type.
Must not be:
const
true object Required
Must not be:
const
false object
boolean
A flag determining if the image is simple or complex. A simple image contains a source url and an alternate text of an image. A complex image contains a simple image, caption, details and a click-through URL.
object
Minimum size of the image.
integer Required
Width of the image in pixels.
Value must be greater or equal to 0 and lesser or equal to 10000
integer Required
Height of the image in pixels.
Value must be greater or equal to 0 and lesser or equal to 10000
array of enum (of string)
The set of aspect ratios supported by the image type.
Must contain a maximum of 1 items
Each item of this array must be:
Must be one of:
- null
- null
- null
- null
- null
- null
- null
- null
- null
- null
integer
The horizontal value for the aspect ratio.
integer
The vertical value for the aspect ratio.
boolean
Flag to determine if a custom aspect ratio is supported by this image.
boolean
Flag to determine if any aspect ratio is allowed.
object
A Rich Text type, which contains a text that can be decorated with common formatting options such as bold and italics. Updated version of Rich Text Type Built on Meta’s Lexical library.
integer
The minimum length of the text.
Value must be greater or equal to 0
integer
The maximum length of the text.
Value must be greater or equal to 0
object
The supported formats of the type
array of enum (of string)
List of supported rich text v2 formats.
Each item of this array must be:
Supported rich text v2 format.
Must be one of:
- “BOLD”
- “ITALICS”
- “UNDERLINE”
- “BULLETED_LIST”
- “NUMBERED_LIST”
- “HYPERLINK”
- “IMAGE”
- “CODE_SPAN”
- “HEADINGS”
- “HORIZONTAL_LINE”
- “STRIKETHROUGH”
- “BLOCK_QUOTE”
- “SUPERSCRIPT”
- “SUBSCRIPT”
- “CODE_BLOCK”
- “TABLE”
- “HIGHLIGHT”
- “TEXT_COLOR”
- “ALIGN”
object
A List type.
string Required
The type ID of the list items.
integer
Minimum size of the list.
Value must be greater or equal to 0
integer
Maximum size of the list.
Value must be greater or equal to 0
The type of the list items.
object
An Entity reference type.
array of string
List of support entity type IDs.
Each item of this array must be:
const
The type of entity reference relationship.
Specific value:“ONE_WAY” object
A Markdown type, which contains a text that can be formatted using the Markdown markup language.
integer
The minimum length of the text.
Value must be greater or equal to 0
integer
The maximum length of the text.
Value must be greater or equal to 0
object
An Option type that contains a list of values (options) that a user can select from.
array of object
A list of available options for this type.
Each item of this array must be:
string Required
The display name of an option.
string Required
The value of an option.
array
Translations of the displayName for different locale codes.
Each item of this array must be:
boolean
Flag that determines if this type has no options.
object
A Rich Text type, which contains a text that can be decorated with common formatting options such as bold and italics.
integer
The minimum length of the text.
Value must be greater or equal to 0
integer
The maximum length of the text.
Value must be greater or equal to 0
array of enum (of string)
List of supported rich text formats.
Each item of this array must be:
Supported rich text format.
Must be one of:
- “BOLD”
- “ITALICS”
- “UNDERLINE”
- “BULLETED_LIST”
- “NUMBERED_LIST”
- “HYPERLINK”
- “IMAGE”
- “CODE_SPAN”
- “HEADINGS”
- “HORIZONTAL_LINE”
- “STRIKETHROUGH”
- “BLOCK_QUOTE”
- “SUPERSCRIPT”
- “SUBSCRIPT”
- “CODE_BLOCK”
boolean
A flag determining if this type supports no rich text formats.
object
A String type.
enum (of string) Required
The stereotype of the value for this field type, which can be a single-line text (SIMPLE), multiline text (MULTILINE), url (URL) or a slug string (SLUG).
Must be one of:
- “SIMPLE”
- “MULTILINE”
- “URL”
- “SLUG”
integer
The minimum length of the text.
Value must be greater or equal to 0
integer
The maximum length of the text.
Value must be greater or equal to 0
object
A Struct type which contains a group of subfields that each have a unique subfield ID.
Same definition as type_structTypeobject
A Video type.
If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.
const Required
true Must not be:
The following properties are required:
- descriptionType
If the conditions in the “If” tab are respected, then the conditions in the “Then” tab should be respected. Otherwise, the conditions in the “Else” tab should be respected.
const Required
false The following properties are required:
- descriptionType
boolean
A flag determining if the video is simple or complex. A simple video contains a source url a video. A complex image contains a simple video and a description.
object
Type of description of the video.
enum (of string) Required
The stereotype of the description of the video.
Must be one of:
- “MULTILINE”
integer
Minimum length of the description.
Value must be greater or equal to 0
integer
Maximum length of the description.
Value must be greater or equal to 0