Create, move and sort categories
ps_manage_categories
Creates new categories, moves them to another place in the menu and sets the order of products in a category.
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
„Create a Black Friday category under Home, but keep it hidden for now.”
Example preview
New category "Black Friday" under 2 Home, text in all languages, status OFF. Meta title: empty (the name is used). Add products with ps_set_product_categories.
Technical details
action=create adds a category (name, parent_id defaulting to Home, descriptions and meta); it starts SWITCHED OFF unless active=true and its texts go to all languages (translations: ps_update_category_content). action=move puts a category (category_id) under another parent (parent_id); the category URL stays, the menu and breadcrumbs change. action=sort_products sets the product order in a category for the "position" sorting: the listed products go first in that order, the others keep their order behind them. Texts of existing categories: ps_update_category_content.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: create | move | sort_products | yes | create | move | sort_products. |
| 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. |
| category_id | integer | when: action=move or sort_products | move / sort_products: the category. |
| parent_id | integer | when: action=move | create / move: the parent category. |
| name | string | when: action=create | create: name (in all languages; translations with ps_update_category_content). Max 128 characters. |
| description | string (HTML) | no | create: description (HTML). Max 65,000 characters. |
| additional_description | string (HTML) | no | create: description below the product list (HTML). Max 65,000 characters. |
| meta_title | string | no | create: meta title. Max 255 characters. |
| meta_description | string | no | create: meta description. Max 512 characters. |
| active | boolean | no | create: switch on right away (default no). |
| products | array of string | when: action=sort_products | sort_products: products to put at the top of the list, in this order. Max 200 items. |
| 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 action per call. sort_products: up to 200 products. A new category is off by default. ps_revert_change removes a new category only while it is empty; moves and sorting are revertible.
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
- Set product categories ps_set_product_categories
- Update category content ps_update_category_content
- Category tree ps_get_category_tree
- Revert change ps_revert_change
Use cases with this tool
- Launch a new collection: category texts and product assignment
- Create new categories and move products into them
Last updated: 2026-10-05