> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogniagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attaching and mentioning files

> Attach a file to a message, or type @ to point at one already in the task — so your AI coworker knows exactly which file you mean.

Two ways to put a file in front of your coworker, depending on whether it's already in the task.

## Attaching

The paperclip in the message box, or drag a file onto the conversation. Attached files appear above the box before you send, so you can check you grabbed the right one and remove it if not.

<Frame caption="Attachments sit above the box until you send, each with its size and a way to remove it.">
  <img src="https://mintcdn.com/glorium/JBtd_griZWPnHu68/images/cowork/files/attaching-and-mentioning/02-attachments.webp?fit=max&auto=format&n=JBtd_griZWPnHu68&q=85&s=8f50de50cd7ade67b30a4d5116952965" alt="Two attached spreadsheets shown above the message box before sending" width="1280" height="268" data-path="images/cowork/files/attaching-and-mentioning/02-attachments.webp" />
</Frame>

Attach when the file is new to the task.

## Mentioning

Type `@` and a menu of the files already in the task appears. Keep typing to filter, pick one, and it's referenced in your message.

<Frame caption="Everything already in the task, with sizes — so you can tell two similar exports apart.">
  <img src="https://mintcdn.com/glorium/JBtd_griZWPnHu68/images/cowork/files/attaching-and-mentioning/01-mention-menu.webp?fit=max&auto=format&n=JBtd_griZWPnHu68&q=85&s=bbd7862987f79c34d07e0207f8e13d51" alt="The mention menu listing the task's files with their sizes" width="768" height="1900" data-path="images/cowork/files/attaching-and-mentioning/01-mention-menu.webp" />
</Frame>

Mention when the file is already there and you want to be unambiguous:

```
Compare @Q3-sales-export.csv against @Q3-forecast.xlsx and tell me where they disagree
```

That says exactly which two files, with no room for your coworker to pick the wrong one.

## When mentioning is worth it

* More than one file in the task could plausibly be the one you mean
* Filenames are similar — `export.csv` and `export-final.csv`
* You're referring back to something from earlier in a long conversation
* The task has a lot of files and you want to be precise

Otherwise, just describe it. "The sales export" works fine when there's only one.

<Tip>
  **Mention rather than re-upload.** Uploading the same file twice gives your coworker two copies and a decision to make about which is current.
</Tip>

## Good to know

<Note>
  Attaching a file adds it to the task's files, so it stays available for the rest of the conversation. You attach once, then mention it afterwards.
</Note>

<Tip>
  Attach several at once when they belong together. "Reconcile these two" with both attached is clearer than two messages.
</Tip>

## Common questions

<AccordionGroup>
  <Accordion title="Can I attach an image?" icon="image">
    Yes. Whether your coworker can *look* at it depends on the model — the picker marks the ones that accept images. See [Effort and model](/cowork/chat/effort-and-model).
  </Accordion>

  <Accordion title="Does mentioning a file make my coworker read all of it?" icon="book-open">
    It reads what it needs for the job. Saying what you want from the file — "just the totals row" — keeps it efficient on a large one.
  </Accordion>

  <Accordion title="Can I mention a coworker file, not a task file?" icon="user-gear">
    Files saved to the coworker are available in every task automatically, so there's usually nothing to point at. Naming it in words is enough.
  </Accordion>

  <Accordion title="What if I attach the wrong file?" icon="xmark">
    Remove it from the strip above the box before sending. After sending, just say so — your coworker won't quietly use the wrong one.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="The file manager" icon="folder-tree" href="/cowork/files/file-manager">
    What's already in the task.
  </Card>

  <Card title="The conversation" icon="comments" href="/cowork/chat/overview">
    Everything else in the message box.
  </Card>

  <Card title="Previewing files" icon="eye" href="/cowork/files/previews">
    Check what you attached.
  </Card>

  <Card title="Files overview" icon="folder" href="/cowork/files/overview">
    Where files live.
  </Card>
</CardGroup>
