You can upload images, videos, and PDF files directly into the AI Assistant and the AI will use them in your app. This is useful when you have a logo, a product photo, a background image, a video clip, a PDF document, or any other asset that you want to use rather than having the AI generate something from scratch.
How to upload an image, video, or file
Attach an image, video, or PDF to your chat message the same way you would in any messaging app — use the attachment button in the chat input, or drag and drop a file into the chat. You can include a message describing where and how you want the file used, or just send it and let the AI decide.
If a file cannot be used for any reason, the AI explains why.
What happens to uploaded files
Uploaded images and videos are placed in your app's public assets folder and referenced from the frontend code. They are available in the deployed app at a stable path — images are embedded using an <img> element, and videos are embedded using a <video> element. Uploaded PDFs are passed directly to the AI as document context so the AI can read their content and use it to inform the build.
If two uploads have the same filename, the second one is automatically renamed with a number suffix to avoid overwriting the first.
Uploading a collection of images
If you upload 5 or more images, the AI will always pause before building and suggest a better approach — no matter what kind of app you are making. It will also suggest this if your prompt mentions a gallery, catalog, portfolio, or similar repeating content, even if you upload fewer than 5 images.
Rather than embedding your images as fixed files, it will offer to build a simple content manager into the app. This lets you log in and add, edit, or remove content at any time without needing to rebuild the app. If you prefer to proceed with static images anyway, just say so and the AI will build exactly what you asked for.
Managing your uploaded files
You can view and manage all the files you have uploaded to a project from the Attachments screen in Project Settings (open the gear icon in the chat panel and select Attachments).
Each file card shows the filename, its size, and the date it was uploaded. To download a file, hover over its preview thumbnail — a download icon appears as an overlay. Click anywhere on the preview to save the file.
To delete files, select them using the checkboxes and click Delete selected. A confirmation dialog appears showing how many files are selected and reminding you that deletion is permanent. For more on chat attachments and storage limits, see Sharing Files with the AI Using Chat Attachments.
When to upload vs. let the AI generate
Upload your own image when:
- You have a specific asset — a logo, a brand image, a product photo — that must appear in the app exactly as-is
- You want a particular style or subject the AI's image generator might not reproduce accurately
Upload a video when:
- You have a clip — a product demo, a background loop, a walkthrough — that you want embedded in the app
- You want a video to play directly in the app without needing external hosting
Upload a PDF when:
- You want the AI to read the contents of a document and use them in your app — for example, a product spec, a price list, or terms and conditions text
Let the AI generate an image when:
- You need illustration, background art, or placeholder content that doesn't need to be a specific real-world image
- You want something that matches the app's visual style automatically
You can mix all of these in the same app. Uploaded images, videos, PDFs, and AI-generated images coexist without conflict.
Frequently asked questions
What file formats are supported?
Common web image formats: JPEG, PNG, WebP, and GIF. Video files (MP4, WebM, MOV) and PDF files are also supported. The AI validates each file before processing it.
Is there a size limit per file?
The maximum file size per upload is 15 MB. Keep uploads reasonable for web use; very large image files will increase your app's load time.
How many files can I upload to a project?
Uploaded files count against a per-project quota. Free plans allow up to 20 files and 100 MB total. Paid plans allow up to 100 files and 500 MB total. AI-generated images do not count against this quota.
Can I upload multiple files at once?
Yes. Attach multiple files to a single message. The AI processes each one and acknowledges all of them in its response.
Can I replace an uploaded image later?
Yes. Upload a new image with the same name and tell the AI to replace the previous one, or describe the change you want — the AI will handle it.
What if I upload a file but don't tell the AI where to use it?
The AI uses its judgment. It will place images where they fit most naturally given your app's context, or use the content of a PDF to inform the build, and will ask you for clarification if the intent is unclear.
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.
Where do I find the Attachments screen?
Open your project, click the gear icon in the chat panel to open Project Settings, and select Attachments.