Category tree
ps_get_category_tree
Read-onlyContent & SEO and Catalog · writes right awayWorks in TellMyShop FreeVisible right after install
Shows how your categories are arranged.
TellMyShop Free: Yes. This tool is in TellMyShop Free, which costs nothing. It only reads your store and never changes anything.
Ask Claude
„Show me the category tree and mark empty categories and ones without a description.”
Example answer
Home (2) > Living room (10, 84 products) > Sofas (12, 31 products, no meta description) > Corner sofas (13, 0 products, inactive) ...
Technical details
Category tree with ID, name, active status, number of active products (direct and in the whole subtree, without double counting) and flags for missing description, meta title and meta description. Use it to find a category ID by name, review the structure, or find empty categories and categories without a description.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| root_id | integer | no | Start category (default the shop's root category). |
| max_depth | integer | no | Depth below root_id (default 4). Range 1 to 10. |
| include_inactive | boolean | no | Show inactive categories (default yes). |
| lang | string | no | ISO language code, for example pl or en. Defaults to the shop's default 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. |
Limits
Max 300 nodes per call. In bigger catalogues narrow it with root_id.
Related tools
- Get category ps_get_category
- Update category content ps_update_category_content
- Set product categories ps_set_product_categories
Use cases with this tool
- Run a full SEO audit of your store
- Turn 'page not found' errors into a plan for old addresses
- Audit the category tree: empty categories and missing texts
- First look at a new client's shop
- Compare product sales with the previous period
- Write SEO texts for category pages
- Move products between categories
- Launch a new collection: category texts and product assignment
- Raise or lower prices for a whole category
- Set a time-limited sale on a category
- Add new products from a supplier list
- Create new categories and move products into them
- Run a promotion on a whole brand or category
Last updated: 2026-10-11