41 lines
1.6 KiB
Plaintext
41 lines
1.6 KiB
Plaintext
---
|
|
group: Widgets
|
|
title: Image
|
|
weight: 16
|
|
---
|
|
|
|
- **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](/docs/widgets#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 files should be saved, relative to the base of the repo |
|
|
| public_folder | string | | _Optional_. Specifies the folder path where the files uploaded by the media library will be accessed, relative to the base of the built site |
|
|
|
|
## Example
|
|
|
|
<CodeTabs>
|
|
```yaml
|
|
name: thumbnail
|
|
label: Featured Image
|
|
widget: image
|
|
default: /uploads/chocolate-dogecoin.jpg
|
|
```
|
|
|
|
```js
|
|
name: 'thumbnail',
|
|
label: 'Featured Image',
|
|
widget: 'image',
|
|
default: '/uploads/chocolate-dogecoin.jpg',
|
|
```
|
|
|
|
</CodeTabs>
|