Update category content
ps_update_category_content
Changes category names, descriptions and SEO texts after you approve a preview.
TellMyShop Free: No. This tool is only in TellMyShop Pro. TellMyShop Free has only ready reports that read your store.
Ask Claude
„Write a 150-word intro for Garden lighting and a longer buying guide below the products.”
Example preview
Category 21 Garden lighting, language en. description: 64 -> 912 characters (diff shown) additional_description: empty -> 3,410 characters meta_title unchanged.
Technical details
Changes name, description, additional description (below the product list), meta title and meta description of categories in one language. Saves like Save in the back office. Does not change the URL (ps_change_url) or the position in the tree.
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. |
| changes | array of object | yes | Changes, one item per category. Max 20 items. Fields of each item: category_id (integer, required): Category ID (ps_get_category_tree). name (string): Name. Max 128 characters. description (string (HTML)): Description (HTML) above the product list. Max 65,000 characters. additional_description (string (HTML)): Additional description (HTML) below the product list, a good place for a longer SEO text. Max 65,000 characters. meta_title (string): Meta title (recommended up to 60 characters). Max 255 characters. meta_description (string): Meta description (recommended 120–160 characters). Max 512 characters. |
| 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 20 categories per call. One language per call.
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 category ps_get_category
- Category tree ps_get_category_tree
- Change URL (slug) ps_change_url
- Revert change ps_revert_change
Use cases with this tool
- Write SEO texts for category pages
- Fix products that share the same title in Google
- Translate category texts and information pages
- Refresh category texts for the season, and switch them back later
- Launch a new collection: category texts and product assignment
- Prepare a Black Friday campaign across the shop
- Translate the whole shop, down to filters and brands
- Get the whole shop ready for Black Friday
Last updated: 2026-10-11