Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Documents component sends downloadable files to users — PDFs, contracts, invoices, images, and any other file type. Each document displays as a clickable card with a filename and opens in a new tab.

​
Format

::: documents
[Display Name](https://url-to-file.pdf) filename:filename.pdf mime:application/pdf
:::
You can include multiple files in a single block: 
::: documents
[Display Name 1](https://url-to-file1.pdf) filename:file1.pdf mime:application/pdf
[Display Name 2](https://url-to-file2.docx) filename:file2.docx mime:application/vnd.openxmlformats-officedocument.wordprocessingml.document
:::

​
Fields

FieldDescription
[Display Name]The label shown to the user on the file card
(url)Direct URL to the file (use the Lua CDN for uploads)
filename:The actual filename with extension (e.g. contract.pdf)
mime:The MIME type of the file (e.g. application/pdf)

​
Example

::: documents
[Loan Agreement](https://cdn.heylua.ai/2a46d577-77d1-490a-9148-b11243000da8.pdf) filename:loan_agreement.pdf mime:application/pdf
[Terms & Conditions](https://cdn.heylua.ai/5f32c891-aa2d-41bc-9e12-c33410000ec9.pdf) filename:terms_and_conditions.pdf mime:application/pdf
:::

​
Common MIME Types

File TypeMIME Type
PDFapplication/pdf
Word (.docx)application/vnd.openxmlformats-officedocument.wordprocessingml.document
Excel (.xlsx)application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
PNG imageimage/png
JPEG imageimage/jpeg
CSVtext/csv

​
Configure in Persona

persona: `
  After completing a loan application, send the agreement documents using:
  
  ::: documents
  [Loan Agreement](url) filename:loan_agreement.pdf mime:application/pdf
  :::
  
  Always confirm the user has received the documents.
`

​
Upload Files with the CDN

Use the Lua CDN API to upload files before referencing them in the documents component. The CDN returns a permanent URL you can include in the block.

CDN API

Upload files and get permanent URLs

​
Best For

  • Loan agreements and contracts
  • Invoices and receipts
  • Policy documents
  • Onboarding packets
  • Reports and summaries
  • Any user-facing file download

Payment Component

Next: Payment links