Manage product images
ps_manage_product_images
Adds product photos from web links, picks the main photo and sets the order of photos.
Free TellMyShop Audit: No. This tool is only in the paid version of TellMyShop. The free TellMyShop Audit has only tools that read your store.
Ask Claude
„Add these two photos to the Nova lamp and make the first one the main photo: https://example.com/nova-1.jpg https://example.com/nova-2.jpg”
Example preview
Product 245 Nova garden lamp, black: add 2 images from example.com. Image 1 becomes the cover. Alt text in all languages: "Nova garden lamp, black". The product has no images yet.
Technical details
action=list shows the product's images (ID, position, cover, alt text, URL). action=add adds up to 10 images from public https links (JPEG, PNG, GIF or WebP, max 10 MB each); legend is the alt text (default: product name), cover=true makes the first new image the cover. action=set_cover sets the cover (image_id). action=reorder puts image_ids at the start in the given order, the rest follow. action=delete removes images (image_ids); this CAN'T BE UNDONE and needs confirm_delete=true. Alt texts of existing images: ps_update_image_legends.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | add | set_cover | reorder | delete | yes | list | add | set_cover | reorder | delete. |
| product | string | yes | Product the way a person refers to it: "id:123", "ref:ABC-1", "ean:5901234123457", a product URL from the shop, a bare ID (1–7 digits), an EAN (8/12/13 digits) or a reference. Max 300 characters. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| lang | string | no | ISO language code, for example pl or en. Defaults to the shop's default language. |
| image_urls | array of string | when: action=add | add: image URLs. Max 10 items. |
| legend | string | no | add: alt text of the new images, in all languages. Max 128 characters. |
| cover | boolean | no | add: make the first new image the cover. Default false. |
| image_id | integer | when: action=set_cover | set_cover: the image. |
| image_ids | array of integer | when: action=reorder or delete | reorder / delete: the images. Max 100 items. |
| confirm_delete | boolean | when: action=delete | delete: confirms the user knows that deletion can't be undone. Default false. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
One product per call. add: up to 10 images, public https links, JPEG/PNG/GIF/WebP, max 10 MB and 40 megapixels each. delete can't be undone (confirm_delete=true); add, set_cover and reorder are revertible with ps_revert_change.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Create or duplicate product ps_create_product
- Update image alt text ps_update_image_legends
- Get product ps_get_product
- Revert change ps_revert_change
Use cases with this tool
- Find products without images, EAN or manufacturer
- Add new products from a supplier list
- Add, reorder or replace product photos
Last updated: 2026-10-05