Update image alt text
ps_update_image_legends
Write · preview + approveContent & SEO and Catalog · writes right awayTellMyShop Pro onlySaves: right awayVisible right after install
Writes descriptions (alt texts) for product photos.
TellMyShop Free: No. This tool is only in TellMyShop Pro. TellMyShop Free has only ready reports that read your store.
Ask Claude
„Add alt texts to all images in Sofas that don't have one. Describe colour and angle.”
Example preview
64 images, language en, only_missing=true. Product 112 image 1: "" -> "Sofa Oslo 3-seat, grey fabric, front view" ... 63 more. 3 images skipped (already have alt).
Technical details
Sets alt texts (legends) of product images in one language. only_missing=true changes only empty ones. An alt describes the image, for example "Black Bartek sandals, side view".
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| lang | string | when: shop has more than one active language | ISO code of the language you write in. Required when the shop has more than one active language. Claude writes the content in this language. |
| 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. |
| items | array of object | yes | Images: image_id, or product + position. Max 100 items. Fields of each item: image_id (integer): Image ID (from ps_get_product). product (string): Together with position, instead of image_id. Product (id:123, ref:ABC-1, ean:..., product URL, ID, EAN or reference). Max 300 characters. position (integer): Position of the image in the product (1 = first). legend (string, required): Alt text. Max 128 characters. |
| only_missing | boolean | no | Change only images without alt text. 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
Max 100 images per call. Alt max 128 characters.
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
- Get product ps_get_product
- Manage product images ps_manage_product_images
- SEO audit ps_audit_seo
- Revert change ps_revert_change
Use cases with this tool
- Describe hundreds of product photos for Google in one go
- Improve the pages of your 20 best sellers
- Add, reorder or replace product photos
Last updated: 2026-10-11