↑↓ selectEnter openEsc close

    1. Elbuz

    Product photos: how to add them, set the main one and not lose them

    6 min readUpdated

    Elbuz keeps all product photos — added by hand, from a price list, a parser or your website — in one card list, and exports start with the first one.

    When you need this:

    • Your photos are on your computer — drag them into the card; oversized ones are shrunk automatically.
    • Customers see the wrong photo — the star on a tile makes it main.
    • A photo is in the card, not the feed — the “eye” on the tile returns it to exports.
    • Hundreds of products need one photo — bulk value setting adds it to all selected.

    Where to start: product card → “Media” section → “Photos” tab.

    What you can do with photos

    How to add photos by hand

    All three methods are at the top of the “Photos” tab.

    1. Drag files into the area labeled “To upload a photo from your computer, drag it here”.
    2. The “Select image from disk” button — a standard file picker; you can select several files at once.
    3. The “Add from URL” link — opens the “File URL” dialog with a single field; the program downloads the image from that address itself.

    Limits for a file from disk: no more than 10 MB and an extension from the list jpeg, jpg, png, gif, webp. The program won't accept a file of any other type and tells you so in a pop-up message.

    Photos tab: drop zone, upload links and the grid of six tiles
    1Drop zone
    2Select image from disk
    3Add from link
    4First tile (main photo)
    1. Drop zone — drag a photo from your computer here.
    2. Select image from disk — opens the file picker.
    3. Add from link — adds a photo by URL.
    4. The first tile is the main photo of the product.

    What happens to the file next runs on its own — you don't start anything:

    • The image is scaled down to 2000 pixels wide, keeping proportions. The original isn't kept, so there's no point uploading larger photos.
    • The file gets a technical name like product_image_181079_776212.jpg in a folder built from the category ID and the product ID. You can't set your own name.
    • If you add a photo by link, the file is first downloaded to a temporary folder and only then goes the same way. The extension is taken from the link; if the link has none, the program uses jpg.
    • Photo counters are recalculated, and so is : in most accounts the photo is one of nine required fields.

    A new photo goes to the end of the list. It doesn't replace the and doesn't become it, even if you uploaded it last and it's the best one.

    To make a photo the main one, move it to the first position — the next section shows how.

    How to make a photo main, hide it or mark it for labels

    Photo tiles are laid out in a grid below the upload area. The order of the tiles is the order of the product's photos, and the first tile is the main photo. The program has no separate “main” mark.

    To change the order, drag a tile to the right place, or click the star on a tile (tooltip “Set as main (first in order)”) to move the photo to first place. Both are saved to the server right away, with no separate button: the program rewrites the order of all the product's photos each time.

    The thumbnail in the product grid doesn't update right away: the grid shows the saved main photo of the product, and that is recalculated during the next catalog update run or bulk operation.

    When photos come from a price list as links on top of existing ones, the program renumbers the order after loading: the photo added earlier stays first, and the new ones go after it. To make another photo the main one, click the star on it.

    When you hover over a tile, four icons appear.

    First photo tile with the four action icons shown on hover
    1Eye
    2Star
    3Label
    4Trash
    1. Eye — hides the photo from exports.
    2. Star — moves the photo to first place and makes it the main one.
    3. Label — sets the label flag.
    4. Trash — deletes the photo immediately, without confirmation.
    IconTooltipWhat it does
    Eye“Active — click to hide” or “Hidden — click to enable”Hides the photo from exports. It stays visible in the card, and the tile is dimmed
    Star“Set as main (first in order)”Moves the tile to first place and saves the new order
    Tag“Use for label (print background)”Marks the photo for printing. The tile shows a “Label” badge
    Trash“Delete image”Deletes the photo immediately, without asking and with no way to restore it

    Clicking the tile itself opens the photo full screen; from there you can browse all the product's photos with the arrows.

    The star and the tag look similar but control different things. The star changes the order: the first photo is shown in the product grid and goes first in exports.

    The tag doesn't reorder anything — it picks the photo that goes into the product's print template as the main image and that AI image generation uses as its base. Only one photo per product can carry the tag: when you mark a new one, the program removes the mark from the previous one.

    Changing the order, hiding a photo and setting the tag clear the photo's internal “Exported” mark. It matters for exports to your own website through the tunnel in only-changed mode: such a photo will be sent there next time. Marketplace feeds don't read this mark — they send all visible photos every time.

    A hidden photo still counts as “has a photo”. The counters — both in the “Media” section header and in the product grid columns — count all photos, hidden or not. But exports take only visible ones.

    So a product with all its photos hidden looks complete in the grid but sends no images to the . If a product's images disappeared from the website but are still in the card, check whether the tiles are dimmed.

    How to check photos without opening product cards

    Without opening any cards, you can see the state of photos in five columns of the product grid.

    Product list grid with photo-related columns
    1Total photos
    2Photo source
    3Do not update photo
    1. Total photos — how many photos each product has.
    2. Photo source — which price list or parser the photos came from.
    3. Do not update photo — flag that protects the photos from updates.
    ColumnWhat it shows
    “Image”Thumbnail of the main photo. Can't be edited in the cell — only by a bulk operation
    “Has photos”Whether there's at least one photo. This field counts toward the card completeness percentage
    “Total photos”How many photos the product has in total, hidden ones included
    “Photo source”Which price list or parser the photos came from
    “Do not update photo (flag)”The same overwrite protection as in the card; edited right in the cell

    The grid itself — filtering products, filters and rolling back bulk operations — is covered in Base catalog product grid.

    How to add or copy a photo to many products

    Add one photo to many products

    Select products in the grid, open “Additional Operations” → “Set value in bulk” and choose the “Image” column. The “Set value” dialog shows a “Select Image” button. The chosen file is added to each selected product as a separate photo — it's an addition, existing photos stay in place.

    The size limit here is 350 KB, not 10 MB as in the card. The program rejects a larger file with “File is too large”, and a file that isn't an image with “Only images are allowed”.

    The same operation without a selected file deletes photos. If you click “Yes” without choosing an image, the program asks again: “ALL photos of the selected products (N) will be deleted along with their files. This cannot be undone — there are no photo backups.” The “Delete photos” button deletes all photos of these products together with their files.

    For other fields, setting a value in bulk keeps an undo log, but for photos it's turned off: you can't get the photos back.

    Adding a file works only on the list of selected products: if nothing is selected, the photo isn't added to anyone. Clearing without a selection applies to the product under the cursor, and the question then shows a count of 1.

    Two things are restricted separately. The “Copy photo to option products” item is shown only to users with the “Button "Add product"” right. And if a group can't edit the “Image” field in the product grid, bulk value setting on this column fails: the program shows “Editing this field is not allowed”, and photos stay unchanged.

    Copy photos to option products

    The “Additional Operations” → “Option products” → “Extra” → “Copy photo to option products” item moves the main product's photos to its variants. It works on one product — the one under the cursor, not the selected ones.

    This is a replacement, not an addition. Each first loses all its photos together with the files, and only then receives copies of the main product's photos — in the same order.

    If the variants had their own photos, for example different colors, they're gone.

    The program doesn't ask for confirmation: it immediately shows “Processing data, please wait...”, and at the end “Operation completed successfully”.

    Variant photos are also controlled by a pair of checkboxes in the source settings — they're described in Option products.

    Which actions delete photos permanently

    There's no trash for photos anywhere, no undo anywhere, and no photo backups on the service side. Here are all the actions after which photos disappear, and what exactly disappears in each case.

    ActionPhoto in the catalogFile in storage
    Trash icon on a tile in the cardremoveddeleted
    “Set value in bulk” with an empty valueremoveddeleted
    “Copy photo to option products”removed from variantsdeleted
    Deleting a single product from the cardremoveddeleted
    Deleting filtered products in the gridremoveddeleted
    “Delete all photos before updating”removedstays in storage; deleted when cloud storage is on
    Deleting a category together with its productsremoveddeleted

    The only row where the file outlives the catalog record is the delete-before-update checkbox in link mode: a photo you once uploaded by hand disappears from the product, but its file stays in storage, taking up space. You can't return it to the product from the interface. What happens to the rest of the product's data on deletion: Product card.

    Scenarios

    A new photo should become the main one

    What to do: drag the file into the upload area on the “Photos” tab, then click the star “Set as main (first in order)” on its tile.

    What you get: the photo becomes first in the list, and the order is saved right away. What won't happen: the thumbnail in the product grid won't update immediately, only with the next catalog update run or bulk operation.

    Remove a photo from the website and feeds without deleting it

    What to do: hover over the tile and click the “eye”.

    What you get: the tile is dimmed, and exports stop taking this photo. What won't happen: the photo counters in the card and the grid still count it, so a product with all photos hidden looks complete.

    One photo for all products in a promotion

    What to do: select the products in the grid, “Additional Operations” → “Set value in bulk”, the “Image” column, “Select Image” — a file up to 350 KB.

    What you get: each selected product gets the photo as a separate tile, existing photos stay. What won't happen: if you click “Yes” without a file, the program offers to delete all photos of these products (bulk operations).

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    “The file "…" cannot be added: only images are allowed.” The extension isn't in the list jpeg, jpg, png, gif, webp — or the file isn't an image at all Re-save the file as JPG or PNG and try again (how to add photos)
    “The file "…" could not be added: the file is too large.” The card has a 10 MB limit per file Compress the file. The program will scale it down to 2000 pixels wide anyway (how to add photos)
    “Only images are allowed” In bulk value setting, the chosen file isn't an image Choose an image (bulk operations)
    “File is too large” Bulk value setting has a 350 KB limit, not 10 MB as in the card Compress the file or add the photo from the product card (bulk operations)
    “Unable to upload file” The transfer was interrupted; the program adds the file number and the browser's message to the text Upload again; if it keeps happening, check the file size and format
    “File upload stopped!” The field in the “File URL” dialog is empty Paste a direct link to the image (how to add photos)
    “Your browser is not supported” The browser can't upload files by drag and drop Use the “Select image from disk” button or update your browser
    “ALL photos of the selected products…” with the “Image” column selected You clicked “Yes” without choosing a file Click “No”. The “Delete photos” button deletes all photos of these products together with their files, and this operation can't be undone (bulk operations)
    “No photos yet” The product has no photos at all Add them by hand or bring them over from a price list (photos from a price list)
    “No product photos” in the card checklist The product has zero photos, which lowers the completeness percentage The line is clickable — it leads to the “Media” section (how to add photos)
    “Operation failed!” after “Copy photo to option products” The product under the cursor has no option products First link the variants to the main product (bulk operations)
    “Processing data, please wait...” stays on screen for a long time Copying photos to variants moves files; the response arrives only at the very end Wait for it to finish (bulk operations)
    The photo is in the card but didn't make it into the feed The photo is hidden — exports take only visible ones Click the “eye” on the tile (order and hidden photos)

    FAQ

    Can I crop a product photo right in the system, without Photoshop?

    No, the card has no image editor: no cropping, no rotating, no resizing. Crop the file in any editor, upload it as a new photo and delete the old one. AI Media Studio can generate a new photo with a different aspect ratio.

    Can I recover deleted photos?

    No. There's no trash for photos, no undo, and no photo backups on the service side. If links to these photos are still in the price list, the next catalog update run will load them again. Photos uploaded by hand can't be recovered in any way.

    Can I set my own file name or alt text?

    No. The file name is always technical — product_image_<product ID>_<photo number>; the name and SKU don't go into it, and there's no bulk renaming. The program also has no place for alt and title text: the storefront and the tunnel receive them empty.

    I replaced a photo, but the marketplace still shows the old one. Why?

    The new photo gets a new address, while the feed the marketplace already picked up points to the old file. The image changes after the next export and once the marketplace picks up the new feed.

    Can I shrink photos or change their format when exporting to a website?

    For a website connected through the tunnel, yes: the “Photo” button in the template sets “Storage format”, “Max width, px” and “Quality, 1-100”. There's no watermark or custom file name there (export through the tunnel).

    Where to find it and who has access

    Menu
    Directories → Base product catalog → Products → product card → “Media” section
    Inside the card
    the “Media” item in the anchor bar under the header
    From the card checklist
    the “No product photos” and “Photos: N · videos: N · files: N” lines lead to “Media”
    From the product grid
    “Additional Operations” → “Set value in bulk”, the “Image” column
    Access right
    the “Products” window; photos have no separate right
    Before you start
    the product must be in a category — the file path is built from it

    There's no separate “Product photos” window in the menu: photos live inside the product card. You get there from the product list.

    Left menu with Directories and Base product catalog expanded
    1Products
    1. Products — opens the product list, from which the product card with photos is opened.

    The “Media” section header shows the counters “Images: N · Videos: N · Files: N” and three sub-tabs — “Photos”, “Video”, “Files”, each with its own counter. This article covers the first one. The “AI Media Studio” button on the right of the header opens AI generation of images and videos — see the separate article AI Media Studio.

    Media section header of the product card with counters and sub-tabs
    1Counters
    2Photos tab
    3AI Media Studio
    1. Counters — shows how many images, videos and files the product has.
    2. Photos — the sub-tab with the product photos.
    3. AI Media Studio — a separate topic, not covered in this article.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free