Yard Docs
Sign in
On this page

Files

Upload files, preview them on a canvas, browse the workspace's files on the Files page, open and edit one in the file dialog, read the files of its repositories, and download them.

Updated November 11, 2026 · 10 min read

A workspace is a real directory on its runner. Everything you upload lands there, and so does anything an agent writes. Yard shows those files in docs, on canvases, and on the Files page.

Uploading

Choose Add, then Note, upload or link and Upload files in the canvas toolbar (or press U), drop files on the canvas, or paste an image. Images become image blocks; anything else becomes a file block. A file can be at most 200 MB. The block appears at once and fills in when the upload finishes. Uploaded files go to the workspace's uploads/ folder.

You can also drop files into a note, where they become attachments.

Previews on the canvas

A file block shows what is in the file, sized to the block:

  • Markdown, rendered;
  • plain text, and code with syntax highlighting and line numbers (HTML, SVG and similar files are shown as code, never rendered);
  • images, video and audio;
  • PDFs, in your browser's own viewer.

Other kinds show a plain card with the name, size and type. Long text shows only its beginning. Double-click the block, or press Enter, to see the whole preview; it has a Download button.

To keep a block small, choose Hide preview from its … menu. It then shows only the file's name, path, size and type. Show preview brings it back.

The Files page

Files, under Home at the top of the sidebar, opens the workspace's files on a page of their own: the tree on the left, the open file on the right. It follows changes on the runner as they happen. A file name in a chat reply, Open in Files on a file or image block, and a link with a file path open the page at that file. On a project's page Files is the project's Files tab (4).

  • The tree has Workspace files (the workspace's docs, prototypes/, research/, uploads/, and a folder per canvas under sheets/) and, under them, Repositories.
  • Upload puts files into the workspace's uploads/ folder without making a block, and Find a file lists the files whose name matches what you type, the workspace's own first and then each repository's. Pick one to open it.
  • Each file row has Add to canvas (the +, or ⌘/Ctrl+Enter on the row), which puts the file on the workspace's canvas, or into the project's context when it belongs to a project; a dot marks files already there, and the toast's Show on canvas goes to the block.
  • The row's … menu (or a right-click on the row) also copies or moves the file between a project and the workspace, and has Download, Copy path and Delete…. Delete asks first; a folder goes with everything in it, and the file's tabs close. What Yard keeps for itself (a project's folder, repos/, .yard/) has no Delete.
  • On the list of every file (the page without a file open), select several rows with their boxes, ⌘/Ctrl-click or Shift-click, and Delete on the bar takes them away at once, without asking. The toast ("4 files deleted") offers Undo for 10 seconds, or ⌘Z/Ctrl+Z while it shows; pointing at it or tabbing into it stops the clock. Docs and prototypes are restored where they were, for everyone; uploads and sheets are only deleted once Undo is no longer offered (when the toast goes, you leave the workspace or close the tab), so other people still see them for those seconds. The same goes for Delete on several rows selected in the sidebar (goals still ask first), and for Remove from sheet on a sheet's selection bar, unless a selected block stands for a monitor.
  • Drag a file row (of the workspace or of a repository) to use it elsewhere:
    • onto the context box above New project to add it to your context;
    • onto a chat's message box: it goes with the next message as an attachment, so the agent reads it;
    • onto a doc's row in the sidebar, or into an open doc: the doc gets a reference to the file (an image shows as a picture, a repository's file as live code);
    • onto a canvas's row in the sidebar: the file becomes a block on that canvas, without leaving the Files page;
    • onto a prototype's row: the file goes on the prototype's canvas, connected to the prototype, so its agent reads it when it makes the next round;
    • onto a project's row: the file goes on the project's canvas (a repository's file adds its repository to the project).

The file dialog

A file of the workspace opened from a doc block, Uploads, a chat or a prototype's page opens in a dialog over the page, which stays as it was beneath. On a phone it takes the whole screen.

  • The head has the file's name, where it is and its kind, Preview and Edit, Unsaved while there are changes, Save (⌘/Ctrl+S), Open beside (the file on the Files page), More (Load from disk) and Close. A repository's files have no Edit, and neither has a file for a viewer, while the runner is offline, or a file that is not text.
  • The body is the file, in the same editor as the Files page.
  • At the side: Where (the workspace and the file's folder, or "atlas repository · read-only"), Edited, Referenced in and Open now (the doc, the chat and the draft that are open).
  • The foot, Use it:, offers only what is open: Attach to chat (the chat shown, by name), Attach to composer (the draft) and Add to this doc (places the file in the doc on screen; a repository's file is copied into uploads/ first). Then Copy path and Download.

Closing with unsaved changes asks first. See also files of a doc.

Repository files

The Files page lists two things in its tree: Workspace files, and under them Repositories, one row for each repository that is in one of the workspace's docs or canvases, with the branch the workspace reads it at. Unfold a repository to see its folders and files; they are listed the first time you do.

A repository file opens on the right, in place of the editor. The line above it says which repository and file it is, the branch, and Read-only: nothing in a repository is uploaded, renamed, deleted or edited here. Changes to a repository are made in a project, on its branch.

  • Open on GitHub opens the file on GitHub, at that branch.
  • Add to canvas (also the + on a file's row) puts a read-only block of the file on the canvas, linked to the repository, beside the repository's block. It is the same block Extract this file makes in a repository's explorer (see Repositories and git); nothing is copied. A picture is copied into uploads/ and becomes an image block instead. Adding the same file twice shows the block that is already there.

Every row of a repository has a … menu too (or right-click): Open on GitHub, Copy path, and Add to canvas for a file. The repository's own row also has Remove from workspace…: after asking, it deletes the workspace's copy of the repository (nothing on GitHub changes; its blocks stay where they are). It is refused while a project works in the repository.

A repository shows here once it has been added to a doc or canvas, and stops showing when its last block is removed or it is removed from the workspace.

Editing and saving

Text files open in a code editor with syntax highlighting: on the Files page, and in the file dialog under Edit. Edit, then press Save or ⌘/Ctrl+S. The path bar says whether the file is saved or has unsaved changes. Leaving with unsaved changes asks first.

A Markdown file (.md, .markdown) opens rendered. Preview and Source in the path bar switch between the page and the editor; Yard remembers which you chose for each file until you close the tab. A link to a line of the file opens it in Source on that line, and a file with unsaved edits stays in Source, where you made them.

Pictures and links in a Markdown preview that use a relative path, such as uploads/x.png, are read from the file's folder first, then from the task directory (the workspace, or the project). For a file under .yard/ (a project's report) they are read from the task directory. A relative link opens that file in Files.

Click a picture in a Markdown preview to open it in the image viewer, the same one a prototype's screens open in: the file's pictures in a strip with ← and → between them, and the picture on a canvas to zoom (the buttons, the wheel, a pinch, or + and −), move, and see at 1:1. Esc closes it. Hold ⌘ or Ctrl when clicking to open the file instead.

If someone else, or an agent, changed the same file meanwhile, Yard merges the two. When the changes clash, the file keeps its current version and the clash waits for review; the Resources header shows a conflicts count.

Some files cannot be edited here:

  • a repository's files are read-only on the workspace's Files page; changes are made in a project's worktree;
  • a project's read-only checkout can be read but not changed; Make writable in the project's Git tab (or yard worktree add <repo> in its terminal) puts it on the project's branch;
  • binary files and very large files are shown, not edited;
  • viewers, and everyone while the runner is offline, see files read-only.

Hidden files

Files and folders whose names start with a dot are left out of the trees. Choose Show hidden files in the … menu of the Files page to show them. The setting is remembered in this browser. A link to a hidden file still opens it.

A project's tree always lists, even with hidden files off, what its agent makes there so you can follow its work:

Folder What it holds Kept in the project's history
.yard/report.md The agent's report yes
.yard/screenshots/ The pictures it takes, and those of Take a screenshot… yes
.yard/sources/ What it makes pictures and files from (a diagram's source, a chart script) yes
.yard/scratch/ Its throwaway files: intermediate output, one-off scripts, Claude Code's scratchpad no

The rest of .yard/ is Yard's own and is never listed.

Downloading

Use Download in a file row's … menu on the Files page or a project's Files tab, in the file dialog, in a file block's expanded view, or on a file attached to a note. A file is always saved under its own name, pictures and PDFs included, rather than opened in a tab.

When an agent links a file it made for you (a PDF, a spreadsheet, an archive) in a reply or in a Markdown file such as a report, a Download button follows the link; see the chat. While the runner is offline, images and files are served from the workspace's stored copy when your organization has storage set up.

Exporting Markdown as .md or PDF

Anything that reads as Markdown has Export, with Markdown (.md) and PDF:

Where Where Export is
A doc the doc's … menu
A Markdown file of the workspace or a project the bar over the file, next to Preview and Source
A Markdown file of a repository the line over the file, on the Files page and the repository's page
A Markdown file or a note opened from a canvas or the library the foot of the expanded view
A project's report the Report card's heading

Markdown (.md) saves the text: a file as it is on disk (in the editor, with your unsaved edits), a doc or a note with its references written as their names. PDF opens your browser's print dialog on the rendered page alone, black on white with its pictures; choose Save as PDF there. The PDF is made in your browser: nothing is sent anywhere. A file too large for its preview is read in full first, so the PDF holds all of it.

Was this page useful?
Edit this page