Skip to main content

How to add images to products and pages

Ask your AI assistant to add an image and it will use the Media Upload tool. There are two ways the file reaches your store, and which one you use depends on where the image currently is.

1. The image is already online​

If the picture is somewhere public — a supplier's site, your own CDN, a shared drive with a direct link — give the assistant the URL and it does the rest:

Add https://example.com/photos/blue-bag.jpg as the main image for SKU 24-MB01

The store downloads the file itself, so nothing passes through the conversation.

note

The link has to point at the file, not at a page showing it. Most "share" links from cloud drives open a preview page instead, and those are refused — look for a "direct link" or "download" URL.

2. The image is on your computer or phone​

An AI assistant cannot send a file into your store by itself, so ask for an upload link:

I have a photo on my phone for SKU 24-MB01. Give me an upload link.

The assistant replies with a link. Open it, choose the file, and the page confirms the upload. Tell the assistant it is done and it continues from there.

The link works in a phone browser, so a photo can go straight from your camera roll into the store. It is valid for 15 minutes, works once, and accepts only the file types allowed for that destination — you do not need to be logged into the admin to use it.

tip

Nothing sensitive travels with the link, so it is safe to open on a phone. It grants exactly one upload into one folder and nothing else.

3. Where the image ends up​

Say what the image is for and the assistant puts it in the right place:

  • A product photo goes into the catalog and is attached to the product's gallery. Ask for it to become the main image and the assistant assigns the image, small image, and thumbnail roles to it.
  • A category image goes into the category media folder, ready to set on the category.
  • Anything else — a banner for a CMS block, an illustration for a page — goes into the media library, the same place the admin's image browser shows.

The assistant reports the file's public URL once it is stored, so you can check the result immediately.

4. Replacing an image​

For a product, ask for the new image to be added and made the main one, then for the old one to be removed. Product images are never overwritten in place: Magento caches resized copies of each image by its file path, so replacing a file's contents would leave the storefront showing the old picture.

For an image in the media library, a page or block that points at it picks up the new file automatically once it is replaced.

warning

Media files are served with long cache headers. After replacing one, visitors and any CDN may keep showing the previous image until the cache expires or you purge it.

5. If an upload is refused​

  • "not accepted here" — the destination takes only certain file types. Product and category images are jpg, png, or gif. To allow documents such as PDFs in the media library, see Additional allowed file types in Settings.
  • "a file already exists" — something is already stored under that name. Ask for a different name, or for the existing file to be replaced.
  • "did not reach the server" — the file is larger than your server's upload limit. Photos straight from a phone often exceed the common 2 MB default; your hosting provider can raise it.
  • Nothing happens at all — writing may be switched off. Check Allow writing to media storage, and that the connected admin role holds the Content -> Media Gallery permission.