These inputs allow editors to upload new files, select existing images, and add external links. Enterprise customers can even configure an external digital asset manager for their team.
File select input with controls to enter external links and upload new files. Does not filter by file type when choosing files.
File inputs are shown for inputs configured with the type
file, or for input keys matching:
Image select inputs with controls to enter external links and upload new image files. Filters files available to choose to files with image extensions.
Image inputs are shown for inputs configured with the type
image, or for input keys matching:
Document select inputs with controls to enter external links and upload new document files. Filters files available to choose to files with document extensions.
Document inputs are shown for inputs configured with the type
document, or for input keys matching:
File path inputs are configured with
options inside an
File path inputs have the following options available:
Paths to common folders. Each path is relative to global site
source. The available keys are:
uploadsfor the default location of newly uploaded site files.
dam_uploadsfor the default location of newly uploaded DAM files.
dam_staticfor the location of statically copied assets for DAM files.
dam_uploads have a number of dynamic placeholders available.
accepts_mime_types- String or array of strings
Restricts which file types are available to select or upload to this input. Optional, each file path input has a different default:
If set as a string, the value should be a comma-separated (no spaces) list of the mime types you want to filter by. The string
* by itself allows any type.
If set as an array, each item should be a string of a single mime type you want to filter by.
Set how an ‘empty’ value will be saved. Does not apply to existing empty values. Can be one of the following:
string- an empty value for this input will be stored as
null- an empty value for this input will be stored as a null value (default). This does not apply to TOML files.
If the input allows for images, the following options are also available:
Defines the width of the bounding box used in the resizing process defined with
Defines the height of the bounding box used in the resizing process defined with
Sets how uploaded image files are resized with a bounding box defined by
height prior to upload. Defaults to
contain. Must be
coverkeeps aspect ratio and ensures the image covers the bounding box
containkeeps aspect ratio and ensures the image fits inside the bounding box
stretchignores aspect ratio and resizes the image to the bounding box
Has no effect when selecting existing images, or if
height are not set.
Sets what format the image is converted to prior to upload. The extension of the file is updated to match. Defaults to keeping the mime type of the uploaded file. Must be one of
Controls whether or not images can be upscaled to fit the bounding box during resize prior to upload. Defaults to
false. Has no effect if files are not resized.
Controls whether or not the JPEG headers defining how an image should be rotated before being displayed is baked into the image prior to upload. Defaults to