The Component Schema Field Object

Retrieve an object of the block’s (component) field schema.

Each field type included in a block can have a set of properties, but some are exclusive to specific types, like Blocks or References.

Properties

type string
The field type.
required boolean
Define the field as mandatory. Defaults to false.
description string
The description displayed in the editor.
tooltip boolean
Set to true to display the description as a tooltip. Defaults to false.
pos number
The field’s position within the block.
id string
The ID of the field.
translatable boolean
Set to true to enable translation. Defaults to false.
default_value string
The field’s default value. Can be an escaped JSON object.
display_name string
The name displayed in the editor.
maximum number
The maximal number of components allowed inside a Blocks field.
minimum number
The minimal number of components allowed inside a Blocks field.
restrict_type string
Specify which blocks are allowed or not inside Blocks and Richtext fields. Supported types are groups (blocks in specific folders), tags (blocks assigned to specific tags), or "" for specific blocks (components). Find the list of component names/group UUIDs/tag IDs in the respective *_whitelist/*_denylist.
restrict_components boolean
Allow or deny access to nestable blocks inside Blocks and Richtext fields. Defaults to false (allowed).
component_whitelist string[]
An array of nestable or universal type block names allowed inside Blocks, Link, and Richtext fields.
component_denylist string[]
An array of block names not allowed inside Blocks, Link, and Richtext fields.
component_tag_whitelist number[]
An array of tag IDs assigned to blocks allowed inside Blocks and Richtext fields.
component_tag_denylist number[]
An array of tag IDs assigned to blocks not allowed inside Blocks and Richtext fields.
component_group_whitelist string[]
An array of group (folder) UUIDs that contain blocks allowed inside Blocks and Richtext fields.
component_group_denylist string[]
An array of group (folder) UUIDs that contain blocks not allowed inside Blocks and Richtext fields.
no_translate boolean
Exclude Text and number fields from translation exports.
rtl boolean
Enable global right-to-left (RTL) support in Markdown, Text, and Textarea fields.
regex string
Client regular expression (regex) validation for the Text field.
max_length number
Set the maximum length of the input string in Markdown, Text, and Textarea fields.
style_options object[]
Objects containing data about custom CSS set inside the Richtext field.
Show child properties
- _uid string
  The unique ID of the style within the story.
- name string
  The style’s name.
- value string
  The style’s value.
customize_toolbar boolean
Set to true to enable a customized toolbar in Markdown and Richtext fields. Defaults to false.
Select relevant toolbar elements to display the toolbar in the Visual Editor.
toolbar string[]
An array of enabled toolbar elements.
allow_target_blank boolean
Allow links in Link and Richtext fields to open in a new tab.
allow_custom_attributes boolean
Enable link custom attributes in Link and Richtext fields.
rich_markdown boolean
Display markdown in Markdown fields as rich text. Defaults to false.
allow_multiline boolean
Allow empty paragraphs in Markdown fields. Defaults to false.
min_value number
The minimal value allowed in a Number field.
max_value number
The maximal value allowed in a Number field.
decimals number
The number of decimal places that appear after the point in a Number field.
steps number
The interval between numbers in a Number field.
disable_time boolean
Disable time selection in the date picker of a Date/Time field. Defaults to false.
inline_label boolean
Display a Boolean field’s label next to the toggle.
exclude_empty_option boolean
Hide empty options in Single-Option and Multi-Options fields.

source enum

The source of Single-Option and Multi-Options fields

Value	Description
`undefined`	Self
`internal_stories`	Stories
`internal_languages`	The languages defined in the space
`external`	API endpoint of a datasource entries array
`internal`	Datasource

options object[]
An array of datasource entries available in Single-Option, Multi-Options, and Plugin fields. Relevant only when the source is undefined (Self).
Show child properties
- _uid string
  The unique ID of the option.
- name string
  The option’s name.
- value string
  The option’s value.
use_uuid boolean
When the source of a Single-Option, Multi-Options, and References field is set to internal_stories (Stories), displays the UUID of the selected story. Defaults to true.
datasource_slug string
When the source of a Single-Option, Multi-Options, or Plugin field is set to internal (Datasource), displays the selectable datasource.
external_datasource string
When the source of a Single-Option and Multi-Options field is set to external (API endpoint of a datasource entries array), define the datasource JSON URL.
folder_slug string
When the source of a Single-Option, Multi-Options, and References field is set to internal_stories (Stories), set the path of the allowed stories folder.
To adapt the path dynamically in a multilingual folder structure, add the {0} placeholder. For example, {0}/categories/.
max_options string
The maximal number of selectable options in Single-Option, Multi-Options, and References fields.
min_options string
The minimal number of selectable options in Single-Option, Multi-Options, and References fields.
filter_content_type string[]
When the source of a Single-Option and Multi-Options, and References field is set to internal_stories (Stories), allow users to select stories from an array of permitted content type blocks.
entry_appearance string
When the source of a Single-Option, Multi-Options, and References field is set to internal_stories (Stories), specify if the option appears as a link (default) or a card.
allow_advanced_search boolean
When the source of a Single-Option, Multi-Options, and References field is set to internal_stories (Stories), allow users to search stories in a modal window that supports filtering, sorting, and pagination. Defaults to false.
is_reference_type boolean
Set to true if the Multi-Options field is a References field.
filetypes string[]
An array of asset file types allowed in Asset and Multi-Assets fields. For example, \["images", "videos", "audios", "texts"\].
asset_folder_id number
Numeric ID of the asset folder allowed in Asset and Multi-Assets fields.
allow_external_url boolean
Allow loading assets from an external URL in Asset and Multi-Assets fields. Defaults to false.
email_link_type boolean
Allow specifying an email address in a Link field. Defaults to false.
asset_link_type boolean
Allow specifying an asset’s URL in a Link field. Defaults to false.
show_anchor boolean
When the URL in a Link field is an Internal link, allow users to define an anchor ID. Defaults to false.
allow_target_blank boolean
Allow links set in a Link field to open in a new tab. Defaults to false.
allow_custom_attributes boolean
Allow setting custom attributes in a Link field. Defaults to false.
restrict_content_types boolean
When the URL in a Link field is an Internal link, allow users to select stories from an array of allowed content type blocks. Defaults to false.
component_whitelist string[]
When restrict_content_types is set to true in a Link field, specify the allowed content type blocks.
force_link_scope boolean
When the URL in a Link field is an Internal link, allow users to only select stories from a specific folder. Defaults to false.
link_scope string
When force_link_scope is set to true in a Link field, specify the allowed path.
keys string[]
An array of field keys displayed in a Group field (not to be confused with field keys that appear in tabs in the Visual Editor).
field_type string
The name of the field type plugin used in aPlugin field.
required_fields string
A comma-separated list of names of fields the user is required to fill in in a Plugin field.
exclude_from_ai_translation boolean
Exclude the field from /docs/manuals/ai-assistance#ai-translations.
exclude_from_merge boolean
Exclude the field when merging (requires the Dimensions App).
exclude_from_overwrite boolean
Exclude the field when overwriting (requires the Dimensions App).
force_merge boolean
Overwrite the field when merging (requires the Dimensions App).
conditional_settings object[]
An array that contains an object with information about conditions set on the field.
Learn more about conditional settings in the Fields concept.

Deprecated fields properties

image_crop boolean
For the deprecated Image field. Activate force crop for images.
keep_image_size boolean
For the deprecated Image field. Keep the original image size.
image_width string
For the deprecated Image field. If keep_image_size is set to true, define the image width in pixels or width ratio.
image_height string
For the deprecated Image field. If keep_image_size is set to true, define the image height in pixels or height ratio.
add_https boolean
For the deprecated Image and File fields. Prepends https: to disallow relative paths.

The following snippet includes only a subset of the available properties:

    "schema": {
      "headline": {
        "type": "text",
        "pos": 0,
        "id": "s94HwQuyR9-3bbmTLRXcjQ"
      },
      "references": {
        "type": "options",
        "pos": 1,
        "is_reference_type": true,
        "source": "internal_stories",
        "entry_appearance": "card",
        "allow_advanced_search": true,
        "folder_slug": "articles/",
        "filter_content_type": [
          "article"
        ],
        "id": "3GLw9V2jTnOs7SKSv1CvtQ"
      },
      "image": {
        "type": "asset",
        "pos": 2,
        "id": "msSxIdkqSB-yVb_-wdVztQ",
        "filetypes": [],
        "asset_folder_id": null,
        "allow_external_url": false
      }
}

Was this page helpful?

This site uses reCAPTCHA and Google's Privacy Policy (opens in a new window).Terms of Service (opens in a new window) apply.

Get in touch with the Storyblok community

Cookie notice

The Component Schema Field Object

Properties

Deprecated fields properties