Browse documentation

Files

Put a filtered list of files on a canvas, upload straight to it, and label several at once.

A files widget shows a filtered list of files on the canvas. To make one, see Create a widget; for the shared editor mechanics, see Build a canvas.

Configure it

Like the tasks widget, the files widget is bound to the built-in Files object, so there's no data source to choose. Its editor has three panels:

  • Columns picks the file fields the list shows: Name, Labels, Updated By and Updated At. Leave it empty to show them all (the list then reads Name, Labels and Updated).
  • Filters & sorting controls which files appear (Filters) and in what order (Sort by).
  • Display holds Auto-fit height of canvas, on for a new widget.
FilesColumnsColumnsSelect columnsFilters & sortingFiltersFilterSort bySortDisplayAuto-fit height of canvasGrow and shrink the widget so its contentalways fits, instead of sizing it for the largestthing anyone might open.Maximum height48 (12rem)Past this the widget stops growing and its contentscrolls instead.
The files widget: pick columns, then filter and sort a list drawn from the built-in Files object.

Working with the list

In view mode the widget lists the matching files with Filter, Sort and Upload files among its header controls (in its ⋯ on a narrow card), so you can add files without leaving the canvas. The list pages through results with a Rows per page selector and a count in the footer.

Label several files at once

Tick the checkboxes of the files you want to change. The widget then offers Set labels and Clear selection in place of its usual controls (in its ⋯ on a narrow card). Set labels opens a dialog: pick the labels in Choose labels… and click Set labels. The labels you pick replace the files' labels; with none picked, the dialog warns that it will remove every label from them. It reaches the files shown on screen, with the widget's filters and the canvas's context applied.

FilesNameLabels1-10 of 25Page 1 of 310NAV pack - Kestrel Euro Bond.pdfShare classes - Q3 2026.xlsxCustody statement - Fabrikam.pdfFilesSet labelsClear selectionExpandExport chartExport card
With files ticked, Set labels applies labels to all of them.

Export

From the widget's ⋯ menu you can export the displayed files as a CSV (Export chart), or Export card to save the list as a PNG. Expand opens it in a large modal.

Let the widget size itself

The Display panel has an Auto-fit height of canvas switch, on for a new widget. While it is on, the card takes the height its content needs rather than the grid rows you drew, up to a ceiling past which it scrolls. See Build a canvas.

Where to go next