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

# Task attachments

> Attach files to a task, preview images inline, download them, and remove them. Includes the 25 MB limit and the full list of allowed file types.

Attach the brief, the screenshot, the signed scope – anything the work needs – straight to the task.

## Where attachments live

The **Attachments** section appears in the task side panel and on the full task page. Files show as thumbnail cards:

* **Images** render a real preview. Click one to open the viewer.
* **Everything else** shows a file-type card with its extension. Click it to download.

Each card carries the file name, a caption, a **download** button and a **remove** button.

## Upload a file

<Steps>
  <Step title="Open the task">
    Go to the **Attachments** section.
  </Step>

  <Step title="Click the add control">
    Your operating system's file picker opens.
  </Step>

  <Step title="Pick the file">
    Upload starts immediately and a loader shows while it runs.
  </Step>

  <Step title="Wait for the confirmation">
    A toast confirms "File attached." The card appears in the grid.
  </Step>
</Steps>

## Limits and allowed types

| Limit                 | Value     |
| --------------------- | --------- |
| Maximum size per file | **25 MB** |

Allowed types:

| Category         | Formats                                             |
| ---------------- | --------------------------------------------------- |
| Images           | PNG, JPEG, GIF, WebP                                |
| Documents        | PDF, plain text, CSV                                |
| Archives         | ZIP                                                 |
| Microsoft Office | Word, Excel, PowerPoint – modern and legacy formats |
| OpenDocument     | Text, spreadsheet, presentation                     |

Anything not on that list is refused. That includes programs and scripts.

<Warning>
  **SVG is not allowed.** An SVG is an active document that can carry scripts, and attachments are served directly, so allowing it would be a security hole. Export the graphic as PNG instead.
</Warning>

If a file is refused you see one of two messages:

| Reason     | Message                                                                                 |
| ---------- | --------------------------------------------------------------------------------------- |
| Too big    | "This file is over the 25 MB limit. Try a smaller file."                                |
| Wrong type | "That file type isn't allowed. Use an image, PDF, doc, spreadsheet, zip, or text file." |

A refused file leaves nothing behind. Nothing is added to the task and the uploaded bytes are discarded.

<Note>
  The size and type are read from the file as it actually landed, not from what your browser claimed. Renaming a file's extension does not get it past the check.
</Note>

## View and download

* **Image** – click the thumbnail to open it in the in-app viewer.
* **Any other file** – click the card, or the download button, to download it.

Download links are minted fresh each time and are short-lived. A copied link stops working shortly afterwards, which is what keeps a file from leaking outside the workspace.

## Remove a file

<Steps>
  <Step title="Click the remove button on the card">
    A confirmation opens: "Remove *filename*?"
  </Step>

  <Step title="Read the warning">
    "This file will be deleted for everyone on this task. This can't be undone."
  </Step>

  <Step title="Confirm">
    A toast confirms "File removed."
  </Step>
</Steps>

<Warning>
  Removing an attachment is **permanent**. Unlike a deleted task, a removed file does not go to Trash and cannot be restored. Download a copy first if you might need it.
</Warning>

## Example

Priya Raman attaches `bluebird-brand-guide.pdf` to `WR-142 Homepage wireframes` on the Bluebird Coffee **Website Redesign** project. The card shows a PDF tile.

Sarah Lin uploads `homepage-v1.png` when the first draft is ready. It renders as a thumbnail, so Priya can check it without downloading anything.

When the client picks a direction, Sarah removes `homepage-v1.png`, confirms the warning, and the task's Activity feed records that an attachment was removed.

## Options and settings

| Control         | What it does                                       |
| --------------- | -------------------------------------------------- |
| Add control     | Opens the file picker                              |
| Thumbnail       | Opens the viewer for images, downloads other files |
| Download button | Downloads the file                                 |
| Remove button   | Opens the permanent-delete confirmation            |

There is no rename. Upload the file under the name you want.

## What happens next

* The task's **Activity** feed records the file being added, with its name and size.
* Removing a file is recorded on the same feed.
* The file is available to everyone who can open the task.

## Permissions

| Action                   | Capability                            |
| ------------------------ | ------------------------------------- |
| See a task's attachments | Project reach – you can open the task |
| Upload a file            | `task.edit`                           |
| Download a file          | Project reach                         |
| Remove a file            | `task.edit`                           |

| Role            | Upload and remove |
| --------------- | ----------------- |
| Owner           | Yes               |
| Admin           | Yes               |
| Project Manager | Yes               |
| Finance         | No                |
| Member          | Yes               |
| Contractor      | Yes               |
| Client          | No                |

Client-portal contacts cannot download task attachments. What a client sees is governed separately – see [/portal/what-clients-can-see](/portal/what-clients-can-see).

## Common questions

<AccordionGroup>
  <Accordion title="How many files can one task have?">
    There is no fixed count. Each file has to be 25 MB or less.
  </Accordion>

  <Accordion title="Can I attach a file to a comment?">
    Files attach to the task, not to a comment. Everyone reading the thread sees them in the Attachments section.
  </Accordion>

  <Accordion title="Can I recover a removed file?">
    No. File removal is permanent and does not pass through Trash.
  </Accordion>

  <Accordion title="Why is my ZIP refused?">
    ZIP is allowed. Check the size – anything over 25 MB is refused whatever the type.
  </Accordion>

  <Accordion title="Do attachments count toward my plan?">
    Attachments are part of the **Projects & tasks** app, which is on the Free plan. There is no separate attachment tier.
  </Accordion>

  <Accordion title="What happens to attachments when a task is deleted?">
    They go with the task to Trash and come back if you restore it. Permanently deleting a task destroys its attachments too.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="This file is over the 25 MB limit">
    Compress it, split it, or share it from your own storage and paste the link into a comment.
  </Accordion>

  <Accordion title="That file type isn't allowed">
    Check the allowed list above. For SVG, export a PNG. For a program or script, put it in a ZIP.
  </Accordion>

  <Accordion title="Couldn't upload that file. You may lack permission.">
    Uploading needs `task.edit`. Finance and Client roles cannot attach files.
  </Accordion>

  <Accordion title="Couldn't open this file">
    The download link had expired. Reload the task and click again – a fresh link is minted each time.
  </Accordion>

  <Accordion title="The thumbnail shows a spinner forever">
    The preview link is still being fetched, or the image is very large. Reload the task.
  </Accordion>
</AccordionGroup>

## Related guides

<CardGroup cols={2}>
  <Card title="Task details" icon="panel-right" href="/tasks/task-details">
    Where the Attachments section sits.
  </Card>

  <Card title="Comments and mentions" icon="message-square" href="/tasks/comments-and-mentions">
    Discussion on the same task.
  </Card>

  <Card title="What clients can see" icon="eye" href="/portal/what-clients-can-see">
    The portal firewall.
  </Card>

  <Card title="Delete and restore a task" icon="trash" href="/tasks/delete-and-restore-a-task">
    What happens to files when a task goes.
  </Card>

  <Card title="Task permissions" icon="lock" href="/tasks/task-permissions">
    Who can upload and remove.
  </Card>
</CardGroup>