Fieldtypes
Fieldtypes are customizable form fields used to structure your content and provide an intuitive content management experience. Each fieldtype has its own UI, data format, and configuration options.
Overview
Fieldtypes are essentially different types of form inputs you can choose from when building a blueprint. They range from simple text fields and select boxes, to more complex WYSIWYG-style editors like Bard.
List of Fieldtypes
Check out the full list of all fieldtypes in our reference section.
Data Format
Fieldtypes are augmented to alter the output of your saved content according to how the field is expected to be used.
For example, a markdown field will automatically convert your plain text input into HTML according to your markdown options of choice. Given the very same input in a textarea field, what you enter is what you return because that fieldtype doesn't alter the content. The documentation for each fieldtype will detail if any augmentation happens.
These same rules apply whether you're using Antlers, Blade, GraphQL, or the REST API.
You can retrieve the original, un-augmented data by using the raw modifier, like so:
{{ markdown_field | raw }}
Options
Each fieldtype has a common set of options in addition to any unique ones specific to that type.
display
The field's label shown in the Control Panel.
handle
The field's template variable. Avoid using reserved words as handles.
instructions
Provide additional field instructions like this text. Markdown formatting is supported.
instructions_position
Where the instructions should be positioned relative to the field. Options: above or below.
variant
Show the field under its label or beside it. Options: block (Stacked), inline (Side by Side). Default: block.
listable
Controls whether the field should be shown in Control Panel listings. Options: hidden, true, or false. Default: hidden.
visibility
Controls whether the field should be shown in Control Panel publish forms. Options: visible, read_only, computed or hidden. Default: visible.
sortable
Control if the field should be sortable in listing views.
replicator_preview
Control preview visibility in Replicator/Bard sets.
duplicate
Control if the field should be included when duplicating the item.
actions
Show or hide field action controls, such as fullscreen mode.
conditions
Configure rules that control whether the field should be shown or hidden. Learn more about conditional fields.
required
Control whether or not this field is required.
validate
Configure rules that validate the value of this field before allowing the user to save. Learn more about validation.
Docs Feedback
Submit improvements, related content, or suggestions through Github.
Betterify this page