documents delivers files: contracts, invoices, policies, reports. The platform never teaches this block, so the model uses it only when your persona or skill context includes the syntax; see Response formatting. Upload the file first, for example with CDN, and reference the URL it returns.
Verified against lua-cli 3.33.0.
Syntax
Fields
Put one file per line. The web widget skips a line that lacks
filename: or mime:; the messaging channels accept the bare [Label](url) form but use both fields when present.
Example
documents rendered as file cards in the web widget
Where it renders
Only the first
::: documents block in a reply is rendered on the messaging channels. To attach a file to email sent from your own address, send it from code with Channels.email.send and its attachments field instead of this block.
See also
- Response formatting — the per-channel matrix
CDN— upload a file and get its URL- images — pictures rather than files