File inputs

Paths to common folders. Each path is relative to global site source. The available keys are:

• uploads for the default location of newly uploaded site files.
• dam_uploads for the default location of newly uploaded DAM files.
• dam_static for the location of statically copied assets for DAM files.

uploads and dam_uploads have a number of dynamic placeholders available.

Restricts which file types are available to select or upload to this input. Optional, each file path input has a different default:

• File: *
• Image: image/x-icon,image/gif,image/jpeg,image/jpeg,image/png,image/webp,image/bmp,image/svg+xml
• Document: application/pdf,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-powerpoint,application/vnd.openxmlformats-officedocument.presentationml.presentation

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 you have one or more DAMs connected to your site, you can use this key to list which asset sources can be uploaded to and selected from.

You can refer to a DAM with the Reference Key field from the site-level DAM configuration.

You can refer to your site files with site-files. If this is omitted from the array, site files will not be available as an asset source for this input.

Defines the width of the bounding box used in the resizing process defined with resize_style.

Defines the height of the bounding box used in the resizing process defined with resize_style.

Sets how uploaded image files are resized with a bounding box defined by width and height prior to upload. Defaults to contain. Must be crop, contain, cover or stretch:

• crop prompts the user to choose a region of the image that matches the bounding box
• cover keeps aspect ratio and ensures the image covers the bounding box
• contain keeps aspect ratio and ensures the image fits inside the bounding box
• stretch ignores aspect ratio and resizes the image to the bounding box

If width and height are not set, contain, cover and stretch have no effect. For crop, width and height are both optional, controlling the minimum size of the crop region and resulting image. The aspect ratio of the crop region is also matched to these values.

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:

• image/jpeg
• image/png
• image/webp

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.

Enable to skip the image resizing process configured for this input when selecting existing images. Defaults to false.

Definitions for creating additional images of different sizes when uploading or selecting existing files. Has no default. Each entry contains the following fields:

• size is a number suffixed with "x" (relative size) or "w" (fixed width) for setting the dimensions of the image (e.g. 2x, 3x, 100w, 360w)
• target is a reference to another input that is given the path to this additional image file

If the additional image cannot be created (i.e. the uploaded image is too small and would need to be upscaled), the target input's value is unset so references to previous files aren't mixed with new ones.