Skip to content

You are viewing documentation for Instruqt 2.0 Labs - our upcoming product releasing in September 2026. For current Tracks documentation, please visitdocs.instruqt.com.

Files


The Files tab holds every file in your lab in a single tree: images and other assets you upload, alongside any other files your resources reference. There’s no separate “Assets” area: uploads, downloads, and general file management all happen here.

The sidebar lists every file and directory in the lab. Use the search icon to filter by name. Click Add (hidden outside edit mode) to:

  • Upload file: add a file from your computer
  • New directory: create a folder to group related files

Each file or directory has a context menu with Copy path, Rename, and Delete. If a file is referenced by a page, task, quiz, tab, or other resource, Rename and Delete are disabled until you remove it from everywhere it’s used. The menu tells you which kind of resource is still using it (e.g. “To delete, remove the file from all pages it’s used in.”).

Uploading opens a drawer titled Upload files to <directory> (or Upload files to root at the top level). You can drag and drop files onto the drop zone or pick them from a file browser.

  • Supported types: jpg, png, PDF, MP4, txt
  • Max file size: 7MB

If a file with the same name already exists in that directory, you’re asked whether to Replace existing files or Keep both files (the new file is renamed with a (1), (2), … suffix).

Selecting a file in the tree opens a preview pane showing its name, size, and a Copy relative path action. Images, videos, and PDFs render inline, text files open in an editable code view while in edit mode, and anything else falls back to a generic binary preview with a Download button.

If the file is used by other resources, the preview header shows a Used by N badge. Hover it to see exactly which resources reference it.

Once uploaded, reference a file from any resource field that accepts a file path (for example a container’s entrypoint script, a task’s validation script, or a note’s embedded image) by its path in the tree, e.g. scripts/setup.sh or images/diagram.png.

Renaming, deleting, uploading, and creating directories all apply immediately: there’s no separate “Add changes” step for file operations, unlike most other resource forms. See Editing & Publishing for how these changes get published once you’re ready.