Haruno Knowledge base

Attachments

Attach files and folders to a message with the paperclip, by dragging, by pasting or from the Files page, and what Haruno does when an attached file moves or disappears.

  • Mac appAvailableDescribed on the Mac's message box page.
  • Windows appAvailable

An attachment gives Haruno a file or a folder to read along with your message. It appears as a small chip above the message box.

Four ways to attach

  • The paperclip. Choose Attach file or folder, then Attach File… or Attach Folder….
  • Drag. Drag files or folders onto the message box. It shows "Drop files to attach".
  • Paste. Press Ctrl+V in the message box. This works for a file you copied in Explorer, and for pictures that exist only on the clipboard, such as a screenshot.
  • The Files page. Right-click a file and choose Add to chat. This works for files, not folders.
The paperclip menu.
The paperclip menu open above the message box, with Attach File and Attach Folder.The paperclip menu open above the message box, with Attach File and Attach Folder.
Dragging a file over the message box.
The message box replaced by a panel that says Drop files to attach.The message box replaced by a panel that says Drop files to attach.

What the chips do

  • A chip shows the file name with a file or folder icon and a × to remove it.
  • The chips go with the message you send. Once it is sent they leave the strip and appear on the message. The next message starts with an empty strip. Attach the file again when you want to send it again.
  • Chips you have not sent yet are kept with the chat. If you leave and reopen it from History, they are back.
  • A message that is only a /command does not take the chips.
  • If you paste a spreadsheet range, you get both the cells as text and a picture of them. Remove the picture chip if you do not want it.

When a file moves or disappears

If an attached file or folder is renamed, moved or deleted before you send, its chip changes. It shows a warning sign instead of the file icon, and a notice under the strip says: "An attachment was moved, renamed, or deleted. Remove it to send."

One chip is fine. The other points to a file that is gone, so Send is switched off.
Two chips above the message box. The second, before.txt, has a warning sign. A notice says an attachment was moved, renamed, or deleted and must be removed to send.Two chips above the message box. The second, before.txt, has a warning sign. A notice says an attachment was moved, renamed, or deleted and must be removed to send.

The Send button is switched off and Enter does not send until you fix it. Either remove the chip, or put the file back. Removing it works at once. Putting the file back is noticed the next time you return to the window or to Chat.

  • Renaming in the Files page renames the chip too. Nothing needs fixing.
  • Renaming outside Haruno, for example in Explorer, is not followed. Haruno marks the chip at the next check, and you attach the new file.
  • Only the chat on screen follows a rename. Another chat's chip for the same file shows as not available when you open it.
Why Haruno blocks the send

Haruno would rather stop than send a message that names a file that no longer exists. Otherwise it would spend its answer searching for the file.

Pasted pictures

  • One paste can add up to 20 items and 32 MB in all. One item can be up to 16 MB. An item over the limit is left out and the rest still attach. Haruno says: "That item is too large to attach. Save it to a file and attach that instead."
  • Pasted pictures get a name such as pasted-image-…png, so two screenshots do not look the same.
  • Haruno keeps pasted files for seven days. When you reopen an older chat, its pasted chips show as not available, and you have to remove them before you can send. Paste the picture again to attach a fresh copy.
  • Text on the clipboard is never thrown away. If the clipboard holds both text and a picture, the text goes in the box and the picture becomes a chip.

What cannot be attached

Programs and shortcuts. Haruno says: "Programs and shortcuts can’t be attached." Everything else can be attached, including scripts, spreadsheets with macros, PDFs and zip files. See How Haruno reads your files.

Size limits

Files that sit inside the project folder are read where they are. Attachments from anywhere else are copied for the chat, because Haruno works in an isolated space. Together, the copies can hold at most 256 MB and 10,000 files. If they are over, the send fails and the message reads: Could not attach "name". Check that it is available, contains no links, and the attachments total at most 256 MB and 10,000 entries.

Every attachment is also checked for malware before it can be sent. See Scanning attachments for malware.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,67 @@
    +---
    +title: Attachments
    +summary: Attach files and folders to a message with the paperclip, by dragging, by pasting or from the Files page, and what Haruno does when an attached file moves or disappears.
    +feature: chat-attachments
    +covers:
    +  - windows-client/docs/chat-attachments.md
    +  - windows-client/haruno-webview/web/src/pages/composerAttachments.ts
    +  - windows-client/haruno-webview/Host/Contracts/WebChatAttachmentCommands.cs
    +  - windows-client/Haruno.Desktop.ViewModels/Items/AttachmentChipItem.cs
    +  - windows-client/Haruno.Desktop.Core/Chat/AttachmentMessage.cs
    +  - windows-client/Haruno.Desktop.Services/Chat/PastedAttachmentStore.cs
    +  - windows-client/Haruno.Desktop.Services/Chat/SandboxAttachmentPreparer.cs
    +---
    +
    +An attachment gives Haruno a file or a folder to read along with your message. It appears as a small chip above the message box.
    +
    +## Four ways to attach
    +
    +- **The paperclip.** Choose **Attach file or folder**, then **Attach File…** or **Attach Folder…**.
    +- **Drag.** Drag files or folders onto the message box. It shows "Drop files to attach".
    +- **Paste.** Press Ctrl+V in the message box. This works for a file you copied in Explorer, and for pictures that exist only on the clipboard, such as a screenshot.
    +- **The Files page.** Right-click a file and choose **Add to chat**. This works for files, not folders.
    +
    +<Shot src="/m/174fa9d80ef7-windows-chat-attach-menu-light.png" dark="/m/01eb6974fec4-windows-chat-attach-menu-dark.png" alt="The paperclip menu open above the message box, with Attach File and Attach Folder." caption="The paperclip menu." />
    +
    +<Shot src="/m/e0eab39c3165-windows-chat-drop-light.png" dark="/m/415d13b18729-windows-chat-drop-dark.png" alt="The message box replaced by a panel that says Drop files to attach." caption="Dragging a file over the message box." />
    +
    +## What the chips do
    +
    +- A chip shows the file name with a file or folder icon and a **×** to remove it.
    +- The chips go with the message you send. Once it is sent they leave the strip and appear on the message. The next message starts with an empty strip. Attach the file again when you want to send it again.
    +- Chips you have not sent yet are kept with the chat. If you leave and reopen it from History, they are back.
    +- A message that is only a `/command` does not take the chips.
    +- If you paste a spreadsheet range, you get both the cells as text and a picture of them. Remove the picture chip if you do not want it.
    +
    +## When a file moves or disappears
    +
    +If an attached file or folder is renamed, moved or deleted before you send, its chip changes. It shows a warning sign instead of the file icon, and a notice under the strip says: "An attachment was moved, renamed, or deleted. Remove it to send."
    +
    +<Shot src="/m/9c38e3999520-windows-chat-attachments-light.png" dark="/m/1888f0dfcb7c-windows-chat-attachments-dark.png" alt="Two chips above the message box. The second, before.txt, has a warning sign. A notice says an attachment was moved, renamed, or deleted and must be removed to send." caption="One chip is fine. The other points to a file that is gone, so Send is switched off." />
    +
    +The Send button is switched off and Enter does not send until you fix it. Either remove the chip, or put the file back. Removing it works at once. Putting the file back is noticed the next time you return to the window or to Chat.
    +
    +- **Renaming in the Files page** renames the chip too. Nothing needs fixing.
    +- **Renaming outside Haruno**, for example in Explorer, is not followed. Haruno marks the chip at the next check, and you attach the new file.
    +- Only the chat on screen follows a rename. Another chat's chip for the same file shows as not available when you open it.
    +
    +<Callout variant="info" title="Why Haruno blocks the send">
    +Haruno would rather stop than send a message that names a file that no longer exists. Otherwise it would spend its answer searching for the file.
    +</Callout>
    +
    +## Pasted pictures
    +
    +- One paste can add up to 20 items and 32 MB in all. One item can be up to 16 MB. An item over the limit is left out and the rest still attach. Haruno says: "That item is too large to attach. Save it to a file and attach that instead."
    +- Pasted pictures get a name such as `pasted-image-…png`, so two screenshots do not look the same.
    +- Haruno keeps pasted files for seven days. When you reopen an older chat, its pasted chips show as not available, and you have to remove them before you can send. Paste the picture again to attach a fresh copy.
    +- Text on the clipboard is never thrown away. If the clipboard holds both text and a picture, the text goes in the box and the picture becomes a chip.
    +
    +## What cannot be attached
    +
    +Programs and shortcuts. Haruno says: "Programs and shortcuts can’t be attached." Everything else can be attached, including scripts, spreadsheets with macros, PDFs and zip files. See [How Haruno reads your files](/windows/chat/reading-files/).
    +
    +## Size limits
    +
    +Files that sit inside the project folder are read where they are. Attachments from anywhere else are copied for the chat, because Haruno works in an isolated space. Together, the copies can hold at most 256 MB and 10,000 files. If they are over, the send fails and the message reads: Could not attach "name". Check that it is available, contains no links, and the attachments total at most 256 MB and 10,000 entries.
    +
    +Every attachment is also checked for malware before it can be sent. See [Scanning attachments for malware](/windows/chat/malware-scanning/).