category-management

name	category-management
description	How to manage categories in a Tiendanube store: create hierarchies, assign products to categories, and handle multilingual category names.

Category Management

Category Structure

A category has:

• name and description: Multilingual objects (keyed by the store's language, e.g. {"es": "..."} for Spanish stores).
• parent: Optional parent category ID for nesting (subcategories).
• handle: URL-friendly slug, auto-generated from name.
• subcategories: Count of child categories.

Hierarchy

• Categories can be nested. Set parent to a category ID to create a subcategory.
• Top-level categories have no parent (or parent = null).
• A category can contain products and subcategories simultaneously.

Multilingual Names

Names are keyed by the store's language. The create_category tool handles this automatically.

Product Assignment

Products are assigned to categories through the product endpoint, not the category endpoint. When creating or updating a product, include "categories": [category_id_1, category_id_2] in the product body.

Common Operations

• Reorganize hierarchy: Update a category's parent field to move it.
• Rename: Update name with new multilingual object.
• Delete: Deleting a category does NOT delete its products. Products remain but lose that category association.