---
title: "Share documents in a message"
space: "Raven"
url: "https://docs.frappe.io/raven/frappe-apps/share-documents"
updated: "2026-10-19"
---

You can send any document from any Frappe app on your site in a message. The document shows as a card with its main details, so people can see it without leaving the chat.

## Attach a document

1. In the message box, click the document button.
2. Under **Document Type**, pick the type of document.
3. Under **Document**, pick the document.
4. Click **Attach**.
5. Type a message if you like, then press **Enter** to send.

<picture>
  <source srcset="/files/raven-dark-apps-attach-dialog.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-apps-attach-dialog.webp" alt="The Attach document from other apps dialog" width="560">
</picture>

Before you send, the document shows above the message box. Point to it to see its details. Click the bin to remove it.

<picture>
  <source srcset="/files/raven-dark-apps-composer-document.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-apps-composer-document.webp" alt="A document attached to a message before it is sent" width="736">
</picture>

You can attach one document to each message. If you attach another one, it replaces the first. You can send files with the same message.

## The document card

The card shows the type of document, its ID, its title and some of its fields. Click the title to open the document in its app.

<picture>
  <source srcset="/files/raven-dark-apps-document-card.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-apps-document-card.webp" alt="A message with a document card" width="728">
</picture>

The buttons at the top right of the card:

| Button | What it does |
| :--- | :--- |
| Copy link | Copies a link to the document. |
| Print | Opens a print preview of the document. |
| Workflow | Shows the workflow actions you can take on the document. Only shows for documents that have a workflow. See [Approve documents from the chat](wiki:ff28074cd1f7). |

Click the ID next to the document type to copy the ID.

Each person sees the card only if they have permission to read the document. Anyone else sees the document type and ID, without the details.

An admin chooses which fields the card shows. See [Document previews](wiki:c95dbb373a9f).

## Print a document or save it as a PDF

1. On the card, click the print button.
2. Pick a **Print format**, a **Letterhead** and a **Language** if you need to. The preview changes to match.
3. Click **Print**, or click **Download PDF**.

<picture>
  <source srcset="/files/raven-dark-apps-print.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-apps-print.webp" alt="The print preview of a document">
</picture>

## Paste a link to a document

You can also paste a link to a document into a message. It is sent as a plain link, without a card. To show the card, attach the document with the document button.

## Attach a file from a message to a document

You can also attach a file that someone sent in Raven to a document.

1. Point to the message with the file and click **⋯**.
2. Click **Attach to document**.
3. Pick the **Document Type** and the **Document**.
4. Click **Attach**.

The file stays on the message too. You need permission to change the document.

## Messages on the document's timeline

Every message with a document card also shows on the document's timeline in Desk. People see it there only if they can read the document and the channel. See [Send a Raven from Desk](wiki:d2adff19d561).

## On the mobile app

Tap **+** in the message box, then tap **Document**. The steps after that are the same.

<picture>
  <source srcset="/files/raven-dark-ios-composer-actions.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-ios-composer-actions.webp" alt="The + menu on the mobile app" width="300">
</picture>

On a phone, the print button opens the preview with a **Download PDF** button. There is no **Print** button.
