Skip to content
Docs menu

Links and attachments on Tasks issues and projects

Add web links to an issue or a project, and attach files to an issue, including large ones, kept in the files of Notes.

View .md

An issue holds more than text. It can carry web links, and files you attach. A project can carry links too.

On an issue, Links sits under the sub-issues and relations, and shows once the issue has a link. On a project, Resources sits under Documents on the Overview. On an issue, choose + Add → Link… (or press ⇧L); on a project, press Add link. Type an address and, if you like, a title, then Add.

The + Add menu

Under the issue's sections, + Add gathers what you can attach to an issue: Sub-issue, Blocked by…, Blocking…, Related to…, Parent issue… (or Change parent…), Link… and Files…. Each relation item shows its shortcut. Sub-issues, relations, links and attachments each show only when the issue has some, so a new issue stays short.

  • A bare address such as github.com/acme/api becomes https://github.com/acme/api. Only http and https addresses are accepted.
  • Fetch title asks the page for its title and fills the field. It is the only time Venom Cloud contacts the site, it happens only when you click, and it is refused for private, local and non-https addresses. Redirects are not followed. Nothing is loaded from the linked site otherwise, so the cards show no favicons.
  • Each link is a compact card with the title (or the host), the host, and Copy, Edit and Remove when you hover or focus it. An issue or project holds up to 100 links.

A project's resources can also be a note; the project's Documents list is where you add them.

Attachments

Under the links, an issue has Attachments. Choose + Add → Files…, drag files onto the page (a drop zone shows while you drag), or paste them anywhere on the issue outside a text box.

Attachments show as a grid of tiles with the name and size under each:

  • Images (PNG, JPEG, GIF, WebP, AVIF) show as thumbnails. A video shows its first frame. A PDF or any other file shows a tile with its type.
  • A click opens the file in a viewer on the page: images at full size, PDFs in the browser's own viewer, video and audio with controls. Use ← and → (or swipe on a phone) to move between files, and Esc or Close to leave.
  • Nothing downloads unless you press Download in the viewer. Files are served with nosniff and a sandbox, as in Notes, and an SVG is never drawn inline.
  • × on a tile (shown on hover, and always on a phone) removes the file from the issue. The file stays in the files of Notes.

Images in the description and comments

Paste or drop an image into the description or a comment and it is uploaded, attached to the issue (so it is listed under Attachments too) and placed in the text. Images in the text show as thumbnails, and a click opens the same viewer, moving between the images of that description or comment. Only images kept by Venom Cloud show in comments; an image written with another site's address stays a link, so reading a comment loads nothing from elsewhere.

The files are Notes uploads of your organisation's vault, so attachments need the Notes add-on (the section is hidden without it) and count toward the 1 GB limit. A file up to 4 MB goes up in one request. A larger file, up to 100 MB, goes up in parts of 3 MB with progress shown, and is assembled on the server. Any member who can change Tasks can attach; the files are readable by every member of the organisation, like the org vault in Notes.

Images, video, audio, PDFs, text and office documents are accepted, as in Notes.

API

Under the Tasks session, in Venom Tasks API: GET/POST /tasks/api/issues/{id}/links and /tasks/api/projects/{id}/links; PATCH/DELETE /tasks/api/links/{id}; POST /tasks/api/links/title; GET/POST /tasks/api/issues/{id}/attachments; the parts routes under /attachments/uploads; and DELETE /tasks/api/attachments/{id}.