static-cms/website/content/docs/widgets/file.md

---
label: "File"
target: file
---

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.

- **Name:** `file`
- **UI:** file picker button opens media gallery
- **Data type:** file path string, based on `media_folder`/`public_folder` configuration
- **Options:**
  - `default`: accepts a file path string; defaults to null
- **Example:**

  ```yaml
  - label: "Manual PDF"
    name: "manual_pdf"
    widget: "file"
    default: "/uploads/general-manual.pdf"
  ```
New design for the widgets section in the docs (#866) * Initial commit for the new widgets section * Placing all the widgets and refining the CSS and Hugo logic * Initial commit for the new widgets section * Placing all the widgets and refining the CSS and Hugo logic * Rebased and updated the info according to @verythorough contribution * Fixing the yaml codes for the relation and select widget sections * Merging with widgets.md and app.j * Fixing some silly mistakes (sorry!) * Following @verythorough contributions :) * Adding the markdown widget and fixing the widgets container background * Adding the URL functionality and myself as a contributor :) * Adding myself as a contributor :) 2018-01-03 20:14:15 -02:00			`---`
			`label: "File"`
convert website from hugo to gatsby (#1369) 2018-07-25 07:47:26 -04:00			`target: file`
New design for the widgets section in the docs (#866) * Initial commit for the new widgets section * Placing all the widgets and refining the CSS and Hugo logic * Initial commit for the new widgets section * Placing all the widgets and refining the CSS and Hugo logic * Rebased and updated the info according to @verythorough contribution * Fixing the yaml codes for the relation and select widget sections * Merging with widgets.md and app.j * Fixing some silly mistakes (sorry!) * Following @verythorough contributions :) * Adding the markdown widget and fixing the widgets container background * Adding the URL functionality and myself as a contributor :) * Adding myself as a contributor :) 2018-01-03 20:14:15 -02:00			`---`

			`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.`

			- Name: `file`
			`- UI: file picker button opens media gallery`
			- Data type: file path string, based on `media_folder`/`public_folder` configuration
			`- Options:`
			- `default`: accepts a file path string; defaults to null
			`- Example:`

			```yaml
			`- label: "Manual PDF"`
			`name: "manual_pdf"`
			`widget: "file"`
			`default: "/uploads/general-manual.pdf"`
convert website from hugo to gatsby (#1369) 2018-07-25 07:47:26 -04:00			```