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.
An issue holds more than text. It can carry web links, and files you attach. A project can carry links too.
Links
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/apibecomeshttps://github.com/acme/api. Onlyhttpandhttpsaddresses 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, andEscor Close to leave. - Nothing downloads unless you press Download in the viewer. Files are served with
nosniffand 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}.