Chat attachments let you upload files directly into the conversation so the AI can read, understand, and use them when building or modifying your app. You can share documents, images, spreadsheets, and other files alongside your prompt — the AI treats them as context for the task you describe.
Why use chat attachments
When you need the AI to work from specific content — a brand guide, a data file, a design mockup, a list of product details — uploading that file is faster and more accurate than copying and pasting. The AI reads the file you attach and uses its contents as part of the build.
How to upload a file
Click the attachment button in the chat input area and select a file, or drag and drop a file directly onto the chat. The file appears as a pill in the prompt area. Add your message describing what you want the AI to do, then send.
You can attach more than one file to a single prompt. Each file appears as a separate pill in the prompt area. Each file must be 15 MB or smaller. Files larger than 15 MB are skipped and a message is shown explaining why.
Managing your uploaded attachments
All files you have uploaded to a project are accessible from Project Settings. Open the settings panel (the gear icon in the chat) and choose Attachments.
The Attachments page shows your current usage — how many files you have uploaded and how much storage they use, relative to your plan's limits — along with a grid of all uploaded files. Each file card shows the filename, its size, and the date it was uploaded. Image files display a preview thumbnail.
From this page you can:
- Select files using the checkboxes and click Add selected to chat to queue them as references in your next prompt
- Download any file by hovering over its preview thumbnail and clicking the download overlay
- Delete files by selecting them and clicking Delete selected — a confirmation dialog appears before anything is removed. Deletion is permanent and cannot be undone.
Referencing an attachment in a prompt
When you add an attachment to the chat — either by uploading it directly or by choosing "Add selected to chat" from the Attachments page — it appears as a pill in the prompt area. You can remove any pill before sending by clicking the X on it.
When you send your message, the referenced attachments are included with your prompt. After the message is sent, the attachment pills are cleared from the prompt area. If a file is later deleted from the Attachments page, the chat history shows "Attachment removed" in place of any earlier preview of that file.
Storage limits
The number of files you can upload and the total storage they can use depends on your plan. The Attachments page shows your current usage against your plan's limits. If you reach the file count or storage limit, you will need to delete existing attachments before uploading more.
Error messages you may see:
- "Attachment file count limit reached for this project" — you have reached the maximum number of files allowed on your plan. Delete some attachments to free up space.
- "Chat attachment storage limit exceeded" — your total attachment storage is full. Delete some attachments before uploading more.
How chat attachments interact with your app's assets
When the AI builds your app, it may generate or update asset files — images, icons, and other static files — that become part of your app's code. If an asset filename matches the name of one of your chat attachments, the AI cannot overwrite it: your uploaded file takes priority and is protected.
In this case, the AI skips the conflicting asset and includes a warning in its response: "Some project assets were not saved because they would overwrite asset of the same name." The warning lists the affected filenames.
To resolve this, remove or rename the conflicting attachment from the Attachments screen, then ask the AI to make the change again.
Frequently asked questions
What file types can I attach?
Any file type up to 15 MB. Images, PDFs, documents, spreadsheets, text files — anything you can select from your file system. Image thumbnails are generated automatically for image files.
Does attaching a file cost credits?
Uploading and storing chat attachments does not itself consume credits. Credits are spent when you send a prompt that triggers a build.
Are chat attachments the same as the file storage in my app?
No. Chat attachments are files you share with the AI during the conversation — they are for the AI's use as context, not for your app's users. File storage (added to your app by asking the AI) is a feature your app's users interact with directly.
Can I download a file I previously uploaded?
Yes. Open Project Settings → Attachments, find the file in the grid, and hover over its preview to download.
Can I delete multiple files at once?
Yes. On the Attachments screen, select as many files as you like using the checkboxes, then click Delete selected. A confirmation dialog shows how many files will be removed before you confirm.
What happens to attachments if I delete my project?
All attachments associated with a project are deleted when the project is deleted.
The AI said it couldn't save some project assets — what does that mean?
One or more of the files the AI tried to generate has the same name as a chat attachment you previously uploaded. The AI protects your uploaded file and skips the conflicting asset. To fix this, open Project Settings → Attachments, delete or rename the file mentioned in the warning, and ask the AI to try the change again.