Images and the media library

Every image your website shows is a real file of the website — not a link to somewhere else. Media in the builder's rail is where those files live, and it is the same place the assistant, the section editor, and the code editor all draw from. Media has two places inside it: Assets, for the logos and graphics your design is made of, and the Library, for your photos, galleries, videos and documents — see Two places a file can live.

Getting a file in

There are three ways, and they all end up in the same library.

• Attach it in the conversation. While the chat is open, drag a photo anywhere over the builder and drop it, or use the paperclip. This is the usual way: you attach the picture and say where it goes — "use this as the header photo" — and the assistant places it for you.
• Upload it in Media. Open Media and drag files anywhere onto the area that lists your files, or use Upload at the top. Nothing is placed on a page; the file is simply available. While you drag, the panel says where the files will land. A drop in Media goes to Media only — while the chat is open instead, every drop goes to the chat.
• Pick it while editing a section. Any image field in Edit mode, every slot on the Branding page and the picture button in a rich-text field open the same Media window, with Upload and the same drop area built in. Select a picture and choose Use image, or double-click it. See Editing your pages.

Uploads are one file at a time under the hood, so a batch of eight photos is eight uploads — you will see them land one by one, the bar under the grid moving with the bytes of the file going up. A file you upload takes its place among the tiles at once, loading, and is selected and scrolled into view the moment it has landed — Media walks to the folder it went to, so you always see where it is.

The grid draws a small copy of each image rather than the full-size file, made once and kept by your browser, so a library you have opened before shows at once — the loading mark on a tile is for a picture you have not seen yet. Double-click a tile to see the full-size picture.

Uploading in Media takes images, videos, audio files, documents, archives, and 3D, CAD and print files — the full list is under What happens to an uploaded image. Files Remote File Search or a website capture brings in land in Media too. Every file can be renamed, filed in a folder, deleted and checked for where it is used; an image field in Edit mode only offers images.

Two places a file can live

Media opens on its two places, and each one holds a different kind of file:

• Assets — your public assets: the logo, the favicon, icons and the graphics your design is made of. They are files of the website itself (its public folder). Every version of your website saves them, so when you restore an earlier version, the logo and the graphics it had come back with it, and they are packed into an export of the website.
• Library — your media library: photos, galleries, blog and post images, videos, audio, PDFs and other documents. Each file is kept once, outside your website's versions, at a readable address made of its folder and its name, such as /media/2026/november/red-barn.jpg. A website with thousands of photos stays quick to save and restore, because a new version does not copy them. Pages show or link to a Library file like any other; it is served on your free address and your own domain alike. The documents you attach in Max's chat are kept here too.

You choose where a file goes by where you add it. Open Assets and upload, and the file is an Asset; open the Library and upload, and it is in the Library. From Media's first screen, Upload and a drop anywhere add to the Library — or drop the files on the Assets or Library card to choose.

One rule keeps your versions light: Assets holds images of 2 MB or less (after optimizing). A video, an audio file, a document, a TIFF or a larger image added to Assets is kept in the Library instead, and the confirmation says so.

The trade-off is worth knowing. Because a Library file is not part of any version, restoring an earlier version does not bring back a Library file you have deleted since, and replacing one replaces it for every version. Keep what belongs to the design in Assets; keep content in the Library.

Folders in the Library

A file added to the Library without choosing a folder is filed by the month it arrives, in 2026/november: the year, then the month. Six thousand photos are then a few dozen folders of a manageable size rather than one endless list. Files that were in your Library before it had folders are filed by the month they were added.

You can make folders of your own in the Library (New folder) and file anything anywhere: open the folder and upload into it, drag a file onto a folder, or right-click a file and choose Move to folder.

A Library file's address is its folder and its name after /media/: red-barn.jpg in the folder 2026/november is at /media/2026/november/red-barn.jpg, and a file at the top of the Library is at /media/red-barn.jpg. Two files in one folder never share a name: a second red-barn.jpg becomes red-barn-2.jpg.

An address never stops working. When you rename a Library file or move it to another folder, it gets a new address, every page that used the old one is changed to the new one, and the old address goes on showing the same file, so a link someone saved or shared elsewhere still works. Every Library file also answers at an older kind of address, which begins /assets/uploads/: pages written before Library files had readable addresses use it, and they keep working. When you delete a file, its addresses show nothing from then on, and they are never given to another file, so an old link can never show a different picture.

Moving files and folders to the other place

Anything can be moved between Assets and the Library afterwards — one file, several, a folder, or several folders at once.

• One file or one folder: right-click it and choose Move to Library (from Assets) or Move to Assets (from the Library). A file's details offer the same.
• Several at once: in the Media window, tick the box that appears on each file or folder as you point at it (or hold ⌘/Ctrl and click; hold Shift and click to take everything in between; x ticks the one in focus). A bar rises from the foot of the window saying what is selected — folders counted with the files they hold — with one button: Move to Library or Move to Assets.

Before anything moves, a confirmation says how many files will go and which will stay behind. Every page and setting that used a moved file follows it to its new address, so nothing on your website breaks. A folder keeps its name and what is inside it: images/gallery arrives in the Library as gallery, and a Library folder logos arrives in Assets as images/logos. A file moved on its own goes to this month's folder in the Library, or to images in Assets.

Moving to the Library takes anything, in any amount. A branding image is the one thing that stays in Assets (change it on the Branding page). A move of more than 50 files runs in the background: a bar in Media shows it copying, updating your pages and removing the originals, and you can keep working — your pages go on showing every picture while it moves. If it is interrupted, start it again; files already in your Library are not copied twice. A move that stops says how far it got — how many files were copied, whether your pages use them yet — and once you close that notice it stays closed.

Moving to Assets is deliberately limited, because every Asset is saved with every version of your website:

• Only images a page can show can be Assets. Videos, PDFs and other files in the selection stay in the Library, and the confirmation says how many.
• More than 10 images in one move shows a warning that Assets is for your logo, icons and the graphics your design is made of. You can still go ahead.
• More than 50 images in one move is refused. Delete what you do not need, or split them into smaller folders and move them in parts.

A picture moved to Assets stays an Asset whatever its size, within your plan's per-file limit.

The Media window

The panel in the rail is the quick view. The button beside its title (⌘⇧M) opens Media in a window over the builder, which is the comfortable way to sort through a lot of files:

• A sidebar with All media, the two places and how many files each holds, and under the place you are in, its folders as a tree.
• Search across everything, with Search in to look in all media, Assets or the Library; a result shows the place and folder it is in, and Show in folder takes you there. All types narrows the view to images, videos, audio or documents.
• Grid or list, remembered for next time.
• Details on the right for the selected file: its size and dimensions, the place and folder it is kept in, its address, the pages that use it, and its alt text. A Library file also shows, under Also answers at, the older /assets/uploads/ address it answers at too.
• Recently added on the first screen: the newest files in your Library.

The same window opens wherever you choose a picture — an image field, a Branding slot, a rich-text field — with Use image at the foot. It remembers the folder you last picked from.

To find a file by name without browsing, open the builder's command menu and choose Find a file in media…: type a few letters, arrow to the file and press Enter, and Media opens on it.

The foot of the sidebar shows how much of your plan's storage the whole organization has used and has left. The same numbers are on the Billing page. When the total is reached, a new upload is refused before anything is stored. A notice appears under the files with what is used, your plan, and the plan with more room. Owners and Admins get an Upgrade plan button (or Contact us when no plan has more) that opens right there. Members get no button, only the owner and each Admin by name with an email link. You can also delete files you no longer need. Nothing already stored is touched.

What happens to an uploaded image

Photos out of a phone or a camera are far larger than a web page needs, so every upload is optimized on the way in:

• Anything wider or taller than 2560 pixels is scaled down to fit.
• JPEG and PNG photos are re-encoded — usually to WebP — when that produces a smaller file without a visible difference.
• SVG, ICO, GIF, AVIF, and BMP files are stored exactly as you uploaded them. These formats are either already small or would be damaged by re-encoding.

The accepted image formats are JPG, JPEG, PNG, WebP, GIF, SVG, ICO, AVIF, and BMP, and a single image may not exceed 50 MB — or your plan's largest file when that is smaller — 50,000 pixels on its longest side, or 100 megapixels in all. Every other file is stored exactly as you uploaded it, in the Library, up to your plan's largest file:

A file named robots.txt, llms.txt, ads.txt or one of the other names the web reads for itself is refused: the website keeps those files itself. Rename yours to upload it. If a file is refused, the message says which limit it passed, and names your plan when the plan is the limit, along with the plan that allows larger files ("Upgrade to Starter for files up to 50 MB"). Resize the file and try again, or upgrade. The plan named is the one that holds the file you tried, so a 60 MB document on Free points to Builder, not Starter. A file too large for every plan offers Contact us. When your plan's limit is what refused the file, owners and Admins get an Upgrade plan button beside the message, even when the library turns the file away before uploading it; everyone else sees who to ask. A photograph over the platform's own image size limit shows no button, because no plan changes that. When you drop several files that are too large, the button is for the largest refused file that has one. An image added to Assets that is still over 2 MB after optimizing is kept in the Library instead; it works on your pages all the same.

What you see in the panel is what a visitor downloads. There is no hidden "original" — the optimized file is the file.

If you need a file kept byte for byte — a print-resolution photograph, an illustration you will crop later — tick Keep originals in the Media window before uploading. Large images make pages slower to load, so leave it off unless you have a reason.

Organizing your files

Assets keeps images under an images folder by default, and you can add folders of your own to keep a large site tidy — images/team, images/menu, and so on. The Library files by year and month, and takes folders of your own too (see Folders in the Library).

Selecting a file shows its dimensions, its file size, the place and folder it is kept in, and where it is used — the pages that reference it, named as pages rather than as file paths. That list is the one thing worth checking before you remove anything.

From Media you can:

• Copy URL to copy the complete dev-site address, including https:// and the site hostname. It points at the latest version of the image and can be pasted outside the builder. Copy <img> tag stays site-relative so the page source remains portable when you connect or change a domain.
• Rename a file. A renamed Library file takes its pages with it, and its old address keeps working, so nothing that links to it breaks.
• Move to folder — by the right-click menu, or by dragging the file onto a folder.
• Duplicate an image, which is handy when you want a variant without losing the original (Assets only; a Library file is kept once and linked from wherever you need it).
• Delete a file, or a folder with everything in it — the dialog says how many files go with it.
• Search by name, which is faster than scrolling once a site has a few dozen files.

Renaming or moving an Asset changes its address, so any page that pointed at the old path now points at nothing. If Media shows the image is used somewhere, either update those pages afterwards or ask the assistant to — "I moved the team photos into images/team, fix the About page." A Library file is different: renaming it or filing it in another folder changes every page that uses it for you, and its old address keeps working. The message that confirms the change says "Every page follows." when pages used the file. If your website was busy at that moment (Max was working on it, say), the message says "Its old address still works." instead: your pages keep the old address, which still shows the file.

Downloading your whole Library

Download at the top of the Media window saves every file in your Library — photos, galleries, videos, PDFs and other documents — as one zip, in the same folders you file them in. Assets are not in it: they are part of your website's design, saved with every version.

A Library can hold thousands of files, so the zip is packed in the background. A card in the bottom-right corner of the builder shows how far it has got — how many files are packed, how much of the total, and about how long is left. You can close Media, keep working, or close the tab: the download carries on, and the card is there again the next time you open the builder.

• Email me when it's ready sends you a link the moment the zip is finished, so you do not have to wait for it.
• Cancel stops it; nothing in your Library is changed either way.
• Fold the card down with the arrow to keep just a small progress badge in the corner.

When the zip is ready your browser downloads it on its own, and the card keeps a Download zip button in case it did not. A finished zip is kept for two days; after that, start a new one. Asking again before anything in your Library has changed hands you the same zip straight away, rather than packing it a second time.

If a file could not be read from storage, the zip is made without it and the card lists the files left out.

Replacing an image

To swap a picture for a better one, upload the new file and point the page at it — either by clicking the image in Edit mode and choosing the new file, or by asking the assistant. Uploading a file with the same name as an existing one does not overwrite it; you get a second file with a distinct name, so nothing you already published can break by accident.

Alt text

Alt text describes the information an image communicates to someone who cannot see it. In AI Settings → Images, Automatically add image alt text is on by default, including for existing websites. Max writes descriptions as it places informative images during a conversation. Turning it off preserves existing text and lets you supply your own descriptions; it does not remove alt attributes or change existing images. Uploading a file to Media alone does not start an AI request or describe it automatically.

To save a description, open the Media window, select an image in Assets, enter Image alt text, and choose Save alt text. (A Library image keeps no saved description: its alt text is written where the image is placed.) Describe what the image communicates, without repeating its filename. Descriptions may contain up to 1,000 characters. Saving a description replaces the alternatives for informative uses of that image in the draft; review the preview and publish when ready. Copy image tag also includes your saved description.

Saved descriptions follow images when renamed, moved, or duplicated in Media. They belong to the website version, so a draft edit does not change the published version. For a different description in one particular context, ask Max to use a separate copy of the image.

Decorative images — a background texture, a divider — are marked as decorative instead, so a screen reader passes over them rather than announcing a filename. Saving a library description leaves existing decorative uses alone. Background images in CSS do not receive HTML alt attributes.

Branding images

The images on the Branding page — your logo, logo mark, mobile logo, dark-background logo, favicon, Apple icon, and social sharing image — are kept in the Assets too, in an images/branding folder, named after the slot they fill (desktop-logo.png, favicon.png, and so on). They carry a Branding asset badge in the grid, and the detail panel names the slot each one fills.

They are ordinary files: you can open them, copy their address, and reference them from a page. What you should not do is delete one casually. Deleting a branding image empties its slot, and your website has no logo (or no favicon) until you choose a replacement — so the delete dialog says which slot it is about to empty before you confirm.

To change one, use the Branding page rather than uploading a replacement here: that keeps the file, the slot, and every page that reads it in step. There is a From media option on every slot, so an image already in Media never has to be uploaded twice.

Where images actually live

If you turn on developer mode, you will find your Assets in the Files panel under public/ — the images folder is public/images. Assets is a friendlier view of that folder, not a separate store, and everything you do in one shows up in the other. Library files are not in the Files panel: they are kept outside the website's versions, each at an address that begins /media/, followed by its folder and its name. Every Library file answers at its older address too, which begins /assets/uploads/.

If your website has its own page or file at a path that begins /media/ (a page called Media at /media/, say), that page or file is what visitors get there, and Library files in other folders keep working beside it.

Next

• Editing your pages — placing and swapping images directly on the page.
• Branding — your logo, favicon, and social sharing image, and the slots they fill.