You are here


Provides an API for creating and managing categories of nodes.
Information CategoryService
Support Status Full Support
Architecture Information Platform Architecture
Description Categories provide a system for organizing content. Unlike tags, which have no hierarchical structure, and which can be created and applied by anyone, categories are created by the Administrator, and are hierarchical in nature. For example, You might have a Europe category, and then sub-categories such as France, Germany, Spain, and so on. The top Category in the hierarchical structure is known as the Root Category.

The CategoryService API provides methods to perform actions such as the following:

  • Create a Category
  • Create a root Category
  • Delete a Category
  • Create a Classification (a grouping of Categories)
  • Delete a Classification
  • Get most popular Categories
Deployment - App Server Deploy as AMP or Simple Module (JAR) package.
Deployment - SDK Project Use SDK archetypes to produce AMP or Simple Module.
Java API Java API documentation
Java example
// To create a root category:
NodeRef newRootCat = categoryService.createRootCategory(

// To create a category
NodeRef newCategory = categoryService.createCategory(newRootCat, "newCategory");

More Information

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.