Image

Name: image
UI: File picker button opens media gallery allowing image files (jpg, jpeg, webp, gif, png, bmp, tiff, svg) only; displays selected image thumbnail
Data type: File path string

The file widget allows editors to upload a file or select an existing one from the media library. The path to the file will be saved to the field as a string.

Widget Options

For common options, see Common widget options.

Name	Type	Default	Description
default	string	`null`	Optional. The default value for the field. Accepts a string.
media_folder	string		Optional. Specifies the folder path where uploaded images should be saved, relative to the base of the repo
public_folder	string		Optional. Specifies the folder path where the image uploaded by the media library will be accessed, relative to the base of the built site
media_library	Media Library Options	`{}`	Optional. Media library settings to apply when the media library is opened by the current widget. See Media Library
choose_url	boolean	`false`	Optional. When set to `false`, the “Insert from URL” button will be hidden
multiple	boolean	`false`	Optional. When set to `true` multiple images are allowed in the widget

Example

name: thumbnail
label: Featured Image
widget: image
default: /uploads/chocolate-dogecoin.jpg

name: 'thumbnail',
label: 'Featured Image',
widget: 'image',
default: '/uploads/chocolate-dogecoin.jpg',

docs

Widget Options

Example