Category Tree ¶
Overview¶
Category Tree is a new entity template that simply create Category entity + Category Item entity just like Espo has with Knowledge Base & Knowledge Base Category.
This extension is ideal for any organizing entities type that benefits from hierarchical classification.
Key Features¶
- Category Tree Entity Template: Creates both category and item entities automatically when you define a new Category Tree type.
- Automatic Relationship Setup: Pre-configured relationships between categories and their associated items.
- Flexible Layout Integration: Automatically adds category fields to list and detail layouts for easy access.
Use Cases¶
- Product Categorization – Organize products into hierarchical categories and subcategories (Electronics → Computers → Laptops).
- Document Management – Structure documents by department, project, or document type with multiple levels.
- Support Ticket Classification – Categorize tickets by issue type, department, or priority levels.
- Multi-level Classification – Any scenario requiring organized, nested categorization of records.
Installation¶
- Obtain the Category Tree extension package from the Eblasoft customer portal.
- Navigate to Administration → Extensions.
- Upload the extension package and click Install.
- Clear cache and rebuild the system when prompted.
Note
Requires EspoCRM 8.0.0 or higher. Compatible up to version 9.2.x.
Usage¶
Creating a Category Tree Entity¶
- Go to Administration → Entity Manager → Create Entity.
- Fill in the entity details: - Label Singular: The singular name (e.g., "Product") - Label Plural: The plural name (e.g., "Products")
- Select Type: Choose Category Tree from the dropdown.
- Click Save.
Tip
When you create a Category Tree with name "Product", the extension automatically creates two entities: " ProductCategory" (for the tree structure) and "Product" (for the actual items).
What Gets Created Automatically¶
When you create a Category Tree entity, the extension automatically:
- Category Entity (e.g., ProductCategory): - Extends the CategoryTree template with tree functionality - Includes parent-child relationship fields - Configured with tree navigation view
- Item Entity (e.g., Product): - Standard Base entity type - Pre-linked to the category entity - Category field automatically added to layouts - Displays with category tree navigation in list view
Working with Categories¶
- Navigate to the Category entity (e.g., ProductCategory).
- Create root-level categories by leaving the Parent field empty.
- Create subcategories by selecting a parent category.
- The tree structure automatically updates to show the hierarchy.
Assigning Items to Categories¶
- Go to your item entity (e.g., Product).
- Create or edit a record.
- Use the Category field to assign the item to a category.
- The item will appear under that category in the tree navigation view.
Changelog ¶
Support & Feedback¶
For assistance:
- Open a support ticket through the Eblasoft customer portal
- Email: support@eblasoft.com.tr
- For documentation improvements, open a GitHub issue


