Attaching Files
Learn how to attach images, documents, and components to your AI messages.
You can attach files to your messages to give AI more context or reference materials. This includes images, documents from your knowledge base, and UI components from your library.
Supported File Types
| Type | Formats | Max Size | Max Files |
|---|---|---|---|
| Images | PNG, JPG, JPEG, WEBP, GIF | 50 MB each | 5 per message |
| Documents | PDF, CSV, MD, HTML, TXT, DOCX | 50 MB each | 5 per message |
| Components | Registry items | — | Unlimited |
Your project has a total storage limit of 1 GB for uploaded files. This includes all images and documents across the project.
How to Attach Files
Using the Add Button
- Click Add in the chat input area
- Choose the file type:
- Upload Images — Upload new images
- Gallery — Select existing images
- Documents — Attach documents
- Components — Add UI components
- Select your files
- Files appear as badges above the chat input
- Type your message and send
Drag and Drop
- Drag files from your computer
- Drop them onto the chat input area
- Files upload automatically
- A confirmation toast appears when done
Using Slash Commands
Type these commands to open specific pickers:
/upload— Open file upload dialog/images— Open image gallery/documents— Open document selector/components— Open component library
Attaching Images
Images help AI understand visual context:
Use Cases
- Reference designs — "Make the hero look like this" with an inspiration image
- Brand assets — Attach logos or brand imagery to include in the page
- Screenshots — Show AI what you're trying to achieve
- Error examples — Attach a screenshot of a visual bug
Image Processing
When you attach an image:
- Image uploads to your media library
- AI analyzes the image content (transcription)
- Processing status shows in the attachment badge
- Once complete, AI can reference the image in its response
Wait for image processing to complete before sending your message. A spinner indicates processing is still happening.
Attaching Documents
Documents add context from your knowledge base:
Use Cases
- Brand guidelines — AI follows your documented brand standards
- Product information — AI uses accurate product details
- Content briefs — Provide specific content requirements
- Research data — Include data AI should reference
Document Processing
When you attach a document:
- Document uploads to your document library
- Content is chunked and indexed for AI search
- Document is added to your knowledge base
- AI can query it during conversations
Only indexed documents can be attached to chat. If a document is still processing, it won't appear in the selector.
Supported Document Types
| Format | Description |
|---|---|
| Research papers, guides, briefs | |
| CSV | Data tables, lists, spreadsheets |
| MD | Markdown documentation |
| HTML | Web content, exported pages |
| TXT | Plain text notes |
| DOCX | Word documents |
Attaching Components
Components give AI reusable UI patterns:
How to Attach
- Open the component library (
/components) - Find the component you want
- Click to select — it's added as an attachment
- Or copy a component and paste it into the chat (auto-detected)
Use Cases
- Request component usage — "Add a [component name] to the features section"
- Style reference — "Use this card component's style for the testimonials"
- Component customization — "Modify this component to show pricing tiers"
Managing Attachments
Viewing Attachments
Attached files appear as badges above the chat input:
- Image attachments show a thumbnail
- Documents show the file name
- Components show the component name
Processing Status
Attachments show their processing status:
- Processing — File is being analyzed
- Ready — File is ready to use
- Error — Processing failed
Removing Attachments
Click the X on any attachment badge to remove it before sending your message.
Limits and Restrictions
Per-Message Limits
- Maximum 5 files per message
- Maximum 50 MB per file
- Images and documents count toward the same limit
Storage Limits
- 1 GB total storage per project
- Includes all uploaded images and documents
- Delete unused files to free up space
File Type Restrictions
Only the supported formats listed above can be uploaded. Other file types will be rejected with an error message.