---
title: Attachments on a person
description: Keep images, files and links with someone in Venom People. Links show as cards with the service's mark and a title made from the address; nothing is fetched from the linked site.
section: cloud
order: 162
audience: [user, agent]
sources: [services/nodejs-cloud/components/people/PersonAttachments.tsx, services/nodejs-cloud/components/people/attachments-client.ts, services/nodejs-cloud/components/people/PersonImages.tsx, services/nodejs-cloud/lib/people/attachments.ts, services/nodejs-cloud/lib/people/attachments-model.ts, services/nodejs-cloud/lib/people/attachments-http.ts, services/nodejs-cloud/lib/people/tools-attachments.ts, services/nodejs-cloud/lib/people/mcp-attachments.ts, services/nodejs-cloud/lib/links/services.ts, services/nodejs-cloud/components/ui/link-card.tsx, services/nodejs-cloud/components/ui/service-mark.tsx, "services/nodejs-cloud/app/api/workspace/people/attachments", "services/nodejs-cloud/app/api/workspace/people/files", services/nodejs-cloud/migrations/0377_people_attachments.sql]
features: [cloud.people]
---

A person's page has an **Attachments** section: the meeting notes, decks, contracts, photos and profiles that go
with someone, in one place, the way Venom Notes keeps files, images and link cards in a note.

## What you can keep

| Kind | What it looks like | Limits |
|---|---|---|
| Images | thumbnails; a tap opens the viewer with the caption, who added it and when, **Download** and **Delete** | PNG, JPEG, WebP or GIF; up to 20 per person, 4 MB each (shrunk in the browser first) |
| Files | a row with the file's type, name and size, who added it and when, **Download**, **Edit** and **Delete** | PDFs, Word, Excel, PowerPoint and OpenDocument files, RTF, text, CSV, Markdown, JSON, audio, video and zip archives; 4 MB each |
| Links | a card with the service's mark, a title, what the link is and its host, and your note; the whole card opens the link in a new tab | any `http` or `https` address; up to 200 files and links per person |

Images come first, then files and links together, newest first. Every file counts toward your organisation's
files quota, the same one Venom Notes uses.

A file's type is read from its bytes, never from its name or the type your browser reports: a PDF renamed
`photo.png` is kept as a PDF. SVG images and HTML pages are refused, because they can carry scripts. Files are
served with `nosniff` and a sandboxing content policy; only images, PDFs, audio and video open in the browser,
anything else downloads.

## Adding

You add to your own people (on a contact you shared with a team or the organisation, your role has to write in
People):

- **Add**, at the top of the section: **Files or photos** (several at once), **Take a photo** on a phone, or **Link**
  (an address, an optional title and a note).
- **Drop** files or a link on the section.
- **Paste** while the section has focus (click or tab to it): a pasted image or file is uploaded, a pasted address
  becomes a link card.

Uploads show their progress; a file that cannot be kept says why. A picture you add is offered for a read into the
profile, as **Add snapshots** does ([Enrich a person from snapshots](/docs/cloud/people-capture.md#enrich-a-person-from-snapshots)).

The same address is kept once per person: adding it again answers the card you already have.

### Links to Venom items

An address of this Venom (a note, an issue, a deal, another person) is not kept as a card. It is linked to the person
and shows under **Linked items**, with the item's own title and state. An address of an item you cannot see is
refused.

## Link cards {#link-cards}

A card shows a mark for the service, a title, what the link is ("Google Doc · docs.google.com") and your note. Click
the title or anywhere on the card to open the link in a new tab. **Edit** renames it and changes the note; an empty
title goes back to the default.

**Nothing is fetched to draw a card.** The title comes from the address alone: the service's label, plus what the
address says when it says something readable:

| Address | Title |
|---|---|
| `https://notes.granola.ai/d/…` | Granola note |
| `https://docs.google.com/document/d/…/edit` | Google Doc |
| `https://www.figma.com/design/…/Pricing-page` | Figma: Pricing page |
| `https://github.com/acme/cloud/pull/12` | GitHub: acme/cloud#12 |
| `https://www.linkedin.com/in/jane-doe-1a2b3c/` | LinkedIn profile: Jane Doe |
| `https://example.com/blog/how-we-price` | How we price · example.com |

Most of these pages need a sign-in, so reading them would only find a login page. Venom does not visit them, and
does not ask a favicon or preview service either.

### Granola notes

A Granola link whose meeting your [Meetings sync](/docs/cloud/people-meetings.md) already holds takes that meeting's title,
says **In your Meetings sync**, and has an **In timeline** link to the meeting's entry on the person's timeline. The
title comes from your own sync, never from Granola's page.

### Recognised services

Granola, Notion, Google Docs, Sheets, Slides, Forms, Drive and Meet, Zoom, Loom, Figma (and FigJam), Linear,
GitHub, GitLab, Slack, Microsoft Teams, Word, Excel, PowerPoint, SharePoint and OneDrive, Dropbox, Box, Airtable,
Miro, Calendly, Cal.com, LinkedIn, X, YouTube, Vimeo, Substack, Medium, HubSpot, Salesforce, DocuSign, Fireflies,
Otter, Fathom and tl;dv. A host counts only as itself or one of its subdomains: `notes.granola.ai` is Granola,
`granola.ai.example.com` is not.

The marks are plain lettermarks drawn in Venom's own icon style and shipped with the app. They are not the
companies' logos, and nothing is loaded from the linked site. Any other address gets a link mark and its host.

## Who sees what

Whoever may see the person sees their attachments: you for a private contact, the team or the organisation for a
shared one. A person you cannot see answers "not found", and so does any of their attachments. Only the person's
owner adds, renames and deletes.

Attachments show in the owner's timeline as **Attached** entries, by the day they were added, and People's search
finds a person by an attachment's title, note or caption (the owner's search, like notes). Titles, notes and file
contents are your data: People's AI never reads a file's contents, and treats the words you typed as data, never as
instructions.

Archiving a person deletes their attachments and the files' bytes. Merging two people moves them to the person you
keep (a link both had is kept once). Attachments are not part of the organisation backup, as People is not in it yet.

## For agents

| Tool | What it does |
|---|---|
| `people_attachment_list` | the images, files and links kept with a person, newest first (`kind` to narrow) |
| `people_attachment_get` | one of them; `include_bytes` returns a file or image up to 1.5 MB as base64 |
| `people_attachment_add` | keep a link (`url`, optional `title`, `note`) or a file: `upload_id` (from `people_image_prepare` with `for: "attachment"` and a `PUT` of the raw bytes, up to 4 MB), `file_url` (a public address Venom fetches) or `file_base64` with `file_name` (about 1.5 MB at most); a picture joins the images; a Venom item's address is refused (use `workspace_item_link`). See [Files and pictures over MCP](/docs/cloud/mcp-files.md) |
| `people_attachment_update` | change a `title` (an image's caption) or a `note` |
| `people_attachment_delete` | delete one |

Each has a REST twin under `/api/v1/people` ([People over MCP](/docs/cloud/people-mcp.md)). The browser uses
`POST /api/workspace/people/attachments`, `PATCH` and `DELETE /api/workspace/people/attachments/{id}`, and
`GET /api/workspace/people/files/{id}` for a file's bytes.
