Attachments
Backlog items and ideas support file attachments for screenshots, specifications, mockups, and other supporting documents. PushBackLog also provides a tenant-wide Attachment Library so you can see every file uploaded across all contexts in one place.
Uploading a File
- Open a backlog item detail page or an idea detail page.
- Scroll to the Attachments section.
- Click Upload or drag-and-drop a file onto the upload zone.
- The file will upload to secure cloud storage and appear in the list with its filename and size.
Supported File Types
- Images: PNG, JPEG, GIF, WebP
- Documents: PDF
- Text: TXT, CSV, Markdown
- Common office formats: DOCX, XLSX
Files outside these types will be rejected with a clear error message.
Viewing Attachments
Click a filename to open the file:
- Images are previewed inline in a lightbox
- PDFs open in a new browser tab
- Other files are downloaded
Deleting Attachments
Click the delete icon next to any attachment. You will be asked to confirm before the file is permanently deleted. Deletion cannot be undone.
Attachment Library
Access the Attachment Library from the main navigation sidebar (Paperclip icon). The library shows every file uploaded across your tenant — ideas and backlog items — in a single, paginated table.
Columns
| Column | Description |
|---|---|
| File | Filename with a document icon |
| Size | File size in human-readable format (KB, MB) |
| Type | MIME sub-type (e.g. pdf, png) |
| Linked to | The idea or backlog item this file is attached to; click the chip to navigate |
| Uploaded | Date the file was uploaded |
Attachments that have been orphaned (all linked entities deleted) are shown with an Unlinked indicator.
Disk Usage Summary
The top of the Attachment Library shows your total storage consumed plus a breakdown by entity type (ideas, items). This is maintained as a running total and updated automatically on every upload and deletion.
Copilot Attachment Workflow
When working with GitHub Copilot and the MCP server, attachments can be referenced by their URL. Copilot can upload files on your behalf using the get_item_attachment_upload_url MCP tool and reference the resulting URL in diary entries or decisions.
Storage Notes
All attachments are stored in a private, tenant-isolated cloud storage bucket. Files are not publicly accessible — each view request generates a time-limited signed URL.