Build and customize

Attach files and images

Add pictures and documents to your request so the agent can use them. Which file types work, the size and count limits, and what to do when a file is refused.

You can send files with your request. The agent reads them and uses them: a logo goes on your page, a price list becomes a table, a brief tells it what to build.

Attach a file in the editor

You have three ways to add a file in the chat.

  1. Click the paperclip. It is on the left of the message box (Attach file). Pick one or more files.
  2. Drag and drop. Drag files over the chat. A dashed outline says "Drop files here". Let go to attach them.
  3. Paste an image. Copy an image, click in the message box and press Ctrl+V (Cmd+V on a Mac).

Each file appears above the message box with its name and size. A small "Uploading…" tag shows while it uploads. Click a file to open it with View. Click the cross on a file to remove it before you send.

Then type your request and press Enter. You can send files without any text. The chat then sends "Please review the attached files."

File types that work

Kind Types
Images JPEG, PNG, WebP, GIF, SVG
Documents PDF, Word (.docx), Excel (.xlsx)
Text Plain text (.txt), CSV, Markdown (.md), JSON

Other types are refused. This includes video, audio, zip files, and some photo formats from phones such as HEIC and AVIF. Convert them to JPEG or PNG first.

The file's real content must match its type. A file renamed from .exe to .png is refused. An SVG that contains script is refused too.

Limits

Limit Where it applies Value
Size of one file Everywhere 10 MB
Files waiting in a message Chat in the editor, and the prompt box on your Home screen 10
Files waiting in a message The prompt box on the public home page, before you sign in 5
Total size of all files in one message The prompt box on the public home page, before you sign in 25 MB
Message text Chat in the editor 4,000 characters

If a file is over the limit, only that file is refused. The others stay attached.

Who can attach files

Owners, admins and editors of a project can add files. People with view-only access, clients and billing admins cannot. If you see "You cannot add files to this project", ask a workspace admin for a higher role. See Roles and what each can do.

You must also be signed in. Before you sign up, the chat says "Sign up to attach files".

What the agent does with your files

  • Images. The agent looks at the picture, including any words in it, and can place it on your site, such as your logo or a product photo. Say where you want it: "Use the attached photo as the banner on the home page."
  • Documents and text. The agent reads the content and uses it. A menu, price list, brief or page text becomes part of your site. Very long documents are read in part, so attach only the pages that matter.

You can attach a file to a plan too. On the plan card, choose Attach files. See Plan mode and Build mode.

When you reply "yes" to a plan or a question, the files from your earlier request go with it, so you do not need to attach them again.

Where your files are kept

Each file is stored in two places. The agent works from a temporary copy that is kept for about an hour. A separate saved copy keeps the file visible in your chat history after you reload the page.

If the agent says a file is no longer available, attach it again. The temporary copy may have expired.

Attach files on the Home screen

The prompt box on your Home screen has an Attach button ("Attach images or documents"). It uses the same file types and the same 10 MB limit per file, with up to 10 files. The files travel with your first message into the new project. See Start from the Home screen.

Messages you may see

Message What it means What to do
"Unsupported file type" The type is not on the list above. Convert the file, or attach a different one.
"File too large (max 10 MB)" The file is over 10 MB. Shrink it, or split it.
"You can attach up to 10 files at once." Ten files are already waiting. Send, or remove some.
"Maximum 10 files allowed" Same limit, on the Home screen. Remove some files.
"Up to 5 files per message" Same limit, on the public home page. Sign in, or remove files.
"Attachments would exceed 25 MB in total" The files together are too big (public home page). Remove a file.
"The file content is not a valid image" (or PDF, or Office document) The content does not match the type. Save the file again from its own app.
"The file is empty" The file has no content. Pick the right file.
"Could not upload" followed by the file name The upload failed. Check your connection and try again.
"Couldn't attach" followed by the file name The file did not attach from the Home screen. Try again, or add it from the chat once the project opens.

If a file keeps failing, try a smaller copy, check your internet connection, and see Troubleshooting.