Cheqq Docs
Guides

Files

Upload, use, download, and remove files, and work with a Wapp's data collections.

Upload a shared file

Select Files in the main navigation.
Drag files anywhere onto the page, or click the upload area to choose them.
Wait for the upload to finish before using the file in chat.

Uploaded files belong to the workspace and are available to Cheqq, every Wapp, and every workspace member — two members of one workspace see the same file tree. The upload area shows your plan's per-file limit, and every upload counts toward your workspace's storage. See Billing for each plan's limits.

Files holds the files you and your workflows put there. What Cheqq makes for you — pages, documents, decks, pictures — lives in Artifacts.

Search by name or path, and filter by type — All, Documents, Images, or Other. Your search and filter stay put when you open a file and come back.

Use files in chat

Attach supported files from the chat input when a request depends on their contents.

Type @ in any chat input to open the file picker: the current thread's files first, grouped by kind with thumbnails and clip durations, then everything in workspace Files. A pick becomes a chip on your message, and that file is the explicit subject of the turn — the image being edited, the clip being extended, or what "this" refers to in Agent mode. A Wapp panel's # mention opens the same picker.

A referenced file that has since left the workspace is reported by name rather than silently swapped for something else.

Preview documents in place

Word documents, PowerPoint decks, spreadsheets, and PDFs open in faithful in-app viewers — DOCX with its real formatting, PPTX slide by slide, spreadsheets as tables with sheet tabs, PDF in your browser's native viewer. The same viewers open from file links in chat and from a record's attachment fields. The viewer's arrows walk every viewable file in your current filter, not just the visible table page. Markdown and text files open in the document editor instead, where Chat starts a conversation about the file and Export downloads it.

Keep a file as an artifact

Select the bookmark icon beside a file — Save to Artifacts — to keep a copy of it as an artifact. It opens straight away, ready to comment on, share, or publish. The original stays in Files, so anything reading it from there keeps working.

A Markdown or text file has two choices in its menu:

  • Save to Artifacts — keep this file as it is, with a link you can share. It reads as formatted text, with headings, lists, checklists, tables and links, and Download gives you the original file.
  • Edit as document — make an editable copy you can work on with others. It opens as a new document, ready to edit, and its history says which file it was made from. Editing it doesn't change the file, and changing the file doesn't change it.

A Markdown or text file you already saved to Artifacts has Make an editable copy at the top, which does the same.

Download or delete

Use the file's menu — Save to Artifacts, Download or Delete file — and Cheqq asks before deleting. Deleting a file removes it from the shared Files area, so confirm that ongoing chats or Wapps no longer need it. A copy you saved to Artifacts is kept.

Work with a Wapp's data collections

Inside a Wapp, its data lives in collections — each with typed fields and up to four layouts: Overview, Grid, Kanban, and List. Click a column header in Grid to rename or edit that field; renaming never breaks existing records, since fields are tracked by a stable ID underneath.

Import and export

Import a CSV or JSON file into a collection from the toolbar — Cheqq walks you through mapping source columns to fields, validates every row, and only commits the import once everything passes (a bad row anywhere blocks the whole import, with a downloadable error report). Export works the other way: choose CSV or JSON and whether to include all fields or only the ones currently visible; it respects your current filter and sort, up to 10,000 records.

Still finishing rollout

Import and export are live today but still finishing final verification — if something looks off, check Troubleshooting or Support.

If an upload fails, confirm the file is within your plan's limit and retry from the Files page. See Troubleshooting for more recovery steps.

Was this page helpful?