Files
TREK/wiki/Documents-and-Files.md
Maurice ad2119efd6 docs(wiki): correct what reading each page whole turned up (#2036)
The last pass reviewed diffs, so it never saw a new paragraph contradicting an
older one on the same page, or a long-standing claim nobody had checked.
Plugin authors were told ctx.config carries their per-user secrets and that
definePlugin takes a permissions key — neither is true, and both fail silently.
FORCE_HTTPS was said to need TRUST_PROXY, which it does not.
2026-08-25 15:22:46 +02:00

4.1 KiB

Documents and Files

Attach and manage documents, tickets, and other files for your trip.

Files

Where to find it

Open the Files tab inside the trip planner, or navigate directly to /trips/:id/files.

Admin: Files is an addon. Enable it in Admin-Addons.

Uploading

Files & Documents page with the All / PDFs / Images / Documents filter tabs, a Trash button, and the empty drag-and-drop upload area listing the allowed file types and 50 MB limit

Drag and drop files onto the upload area, click it to open the file picker, or paste an image directly into the Files panel.

  • Maximum file size: 50 MB per file.
  • Blocked file types: renderable documents (.svg, .svgz, .html, .htm, .shtml, .shtm, .xml, .xhtml, .xht), scripts (.js, .jsx, .ts, .tsx, .mjs, .cjs, .php, .py, .rb, .pl) and executables (.exe, .bat, .sh, .cmd, .msi, .dll, .com, .vbs, .ps1, .app) — these are always rejected, as is any file whose MIME type contains svg.
  • Default allowed types: jpg, jpeg, png, gif, webp, heic, pdf, doc, docx, xls, xlsx, txt, csv, pkpass, pkpasses, md, markdown. An admin can customize the allowed list under Admin → Settings → Allowed File Types — comma-separated extensions, or * to allow everything except the blocked types above.

Requires the file_upload permission.

Browsing and filtering

The toolbar provides filter tabs, in this order: All, a star icon for Starred (only shown when at least one file is starred), PDFs, Images, Documents, and Collab Notes (only shown when files exist from collaborative notes). Each tab shows a count badge.

Previewing files

Clicking a file that is neither an image nor a video (e.g., PDF or Markdown) opens an inline preview modal with options to open in a new tab or download. .pkpass and .pkpasses Wallet passes are the exception: clicking one downloads it straight away, so the OS can hand it to Apple Wallet rather than forcing it into the in-app preview. Clicking an image or video file opens a full-screen lightbox. You can:

  • Navigate between images and videos using the arrow buttons or the left/right arrow keys.
  • Swipe left/right on touch devices.
  • Jump to a specific file using the thumbnail strip at the bottom. Videos have no stored thumbnail and show a play placeholder there.
  • Download or open the file in a new tab from the lightbox header.

Starring

Click the star icon on any file to favorite it. Starred files sort to the top of the list and can be filtered with the Starred tab.

Requires the file_edit permission.

Trash

Deleting a file moves it to the trash. Switch to the trash view using the Trash button in the toolbar. From the trash view you can:

  • Restore a file to make it active again.
  • Permanently delete a single file.
  • Empty trash to permanently remove all trashed files at once.

Restore and delete operations require the file_delete permission.

Linking files to places, reservations, or assignments

A file can be attached to multiple places and reservations at the same time (many-to-many). From the file manager, click the link (pencil) icon on a file to open the assign modal. From there you can toggle links to any trip place or reservation. You can also add a descriptive note to the file in the same modal.

From a reservation modal, use the "link existing file" picker to attach files directly.

Downloading

Click the download icon on any file row to download it. .pkpass files (Apple Wallet passes) are served with the application/vnd.apple.pkpass MIME type, so Safari on iOS and macOS offers to add the pass to Wallet instead of saving it as a generic download.

Permissions

Permission Controls
file_upload Uploading new files.
file_edit Starring and linking files.
file_delete Moving to trash, restoring, and permanently deleting.

See also