Managing categories

Plans supporting management of categories

Professional
Business
Enterprise






Organizing content effectively is key to creating a user-friendly and efficient knowledge base. In Document360, categories and subcategories play a pivotal role in structuring your documentation. Whether you’re creating, renaming, deleting, or moving categories, Document360 provides a wide range of options to customize and manage them to meet your specific needs.

Managing categories helps to create and customize category icons to advanced tasks like cloning, reordering, and starring categories for quick access. With these features, you can ensure your knowledge base remains well-organized and accessible to your team and end users.


Creating a category

In the Knowledge base portal, you can create a category using one of the following methods:

  1. Method 1: Using the Create button on the top bar

  2. Method 2: Using the Flywheel () icon

  3. Method 3: Using the More () icon in the Categories & Articles section.

  4. Method 4: Using the Create button in Folder/Index type category

Document360 interface showing options to create  categories in a workspace.

To create a category using the Create button on the top bar:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Click the Createdropdown and select Category.

    The Create new category panel will appear.

  3. Enter a Name for the new category.

  4. In the Nest category under the dropdown, choose the category’s position (root level or inside an existing category).

  5. Click Reset to create the category in Root level.

  6. Choose the Type of category (Folder, Index, Page, or GitHub).

  7. Click Create.

    A new category or subcategory is added.

To create a category using the Flywheel () icon:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over just below the desired category, and click the Flywheel () icon.

  3. Click Category.

    The Create new category panel will appear.

  4. Enter a Name for the new category.

  5. In the Nest category under the dropdown, choose the category’s position (root level or inside an existing category).

  6. Click Reset to create the category in Root level.

  7. Choose the Type of category (Folder, Index, Page, or GitHub).

  8. Click Create.

    A new category or subcategory is added.

To create a category or sub category using the More () icon in the Categories & Articles section:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category, and click the More () icon.

    The Create new category panel will appear.

  3. Enter a Name for the new category.

  4. In the Nest category under the dropdown, choose the category’s position (root level or inside an existing category).

  5. Click Reset to create the category in Root level.

  6. Choose the Type of category (Folder, Index, Page, or GitHub).

  7. Click Create.

    A new category or subcategory is added.

To create a category using the Create button in a Folder/Index type category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Click the desired Folder/Index type category in the Categories & Articles section.

  3. Click Create dropdown (on the right side of the category page) and select Sub category.

    The Create new category panel will appear.

  4. Enter a Name for the new category.

  5. In the Nest category under the dropdown, choose the category’s position (root level or inside an existing category).

  6. Click Reset to create the category in Root level.

  7. Choose the Type of category (Folder, Index, Page, or GitHub).

  8. Click Create.

    A new category or subcategory is added.

Creating a new category in the Knowledge base portal.

Subcategories level

You can create up to seven levels of categories (1 root category + 6 subcategory levels). The New category option will be disabled for subcategories beyond this limit.

4_Screenshot-Category_manager-Subcategory_levels

NOTE

  • When you have more subcategory levels, the user will find it challenging to navigate and discover the desired article without using the Search option.

  • You can structure the Knowledge base based on your requirement as Document360 facilitates content discoverability using tags, all-in-one search, related articles, internal linking, cloning articles, replicating or sharing one article in multiple categories, and the starred categories/articles feature.

TIP

Use up to three subcategory levels for optimal navigation. Two subcategory levels are ideal.


Changing category icon

When you create a category or subcategory, a default folder icon is assigned. You can change this icon to an emoji to better convey the category’s purpose to your end-users.

  1. Navigate to the Documentation () in the Knowledge base portal.

  2. In the left navigation panel, click the folder icon or emoji adjacent to the desired category.

    An emoji pop-up window will appear. You can find an emoji by using the search bar, looking through the categories along the top, or using the color-tone icons next to the search bar.

  3. Select your desired emoji to apply it.

NOTE

  • To revert to the folder icon, click the 🚫 icon in the emoji pop-up window.

  • Emoji styles may vary depending on the browser.

  • You cannot update the category icon for Page type categories. Category icon can only be updated for Folder or Index type categories.

Document360 interface showing how to change the category icon in the Knowledge base portal.


Deleting a category

There are four ways to delete a category in the Knowledge base portal:

  1. Method 1: Using the More() icon in the Categories & Articles section.

  2. Method 2: Using the More () icon in the Folder/Index category.

  3. Method 3: Deleting multiple articles/categories in the Folder/Index category.

  4. Method 4: Deleting a specific article/sub category in the Folder/Index category.

User interface showing options for managing delete options in the Knowledge base portal.

To delete a specific category from the Categories & Articles section:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category in the Categories & Articles section.

  3. Click the More () icon and select Delete ().

  4. Click Yes in the Delete confirmation panel.  

To delete a specific Folder/Index type category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Click the More () icon and select Delete ().

  4. Click Yes in the Delete confirmation panel.  

To delete a multiple articles and sub categories within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Select the checkboxes for the appropriate articles and subcategories.

  4. Click Delete ().

  5. Click Yes in the Delete confirmation panel.  

To delete a specific article/sub category within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Hover over the desired article/sub category.

  4. Click the More () icon and select Delete ().

  5. Click Yes in the Delete confirmation panel.

NOTE

When you delete a root-level category, all the subcategories and articles under that level will also be deleted. Deleted items will be available in the recycle bin for 30 days.


Hiding and unhiding a category

In Document360, you can hide a category or subcategory within the documentation editor to restrict access to team accounts only. Hidden categories are indicated by a strikethrough in the categories list of the Documentation window.

Suppose your documentation team is drafting a new feature guide that isn't ready for public release. You can temporarily hide the category while it's under review, ensuring that only internal team members can access it. Once finalized, you can unhide the category to make it publicly available.

There are four ways to hide a category in the Knowledge base portal:

  1. Method 1: Using the More () icon in the Categories & Articles section.

  2. Method 2: Using the More () icon in the Folder/Index category.

  3. Method 3: Hiding/Unhiding multiple articles/categories in the Folder/Index category.

  4. Method 4: Hiding/Unhiding a specific article/category in the Folder/Index category.

User interface showing options for managing Hide options in the Knowledge base portal.

To hide/unhide a specific category from the Categories & Articles section:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category in the Categories & Articles section

  3. Click the More () icon and select Hide ().

    To Unhide, click the Unhide () icon.

To hide/unhide a specific Folder/Index type category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Click the More () icon and select Hide ().

    To Unhide, click the Unhide () icon.

To hide/unhide multiple articles and sub categories within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Select the checkboxes for the appropriate articles and subcategories.

  4. Click Hide ().

    To Unhide, click the Unhide () icon.

To hide/unhide a specific article/sub category within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Hover over the desired article/sub category.

  4. Click the More () icon and select Hide ().

    To Unhide, click the Unhide () icon.

NOTE

When you hide a category or subcategory, all its subcategories and articles will also be hidden.


Renaming a category

In Document360, you can rename categories and subcategories as many times as needed.

  1. Navigate to Documentation() in the Knowledge base portal.

  2. Go to the desired category or subcategory.

  3. On the category page, click the category name to edit.

    Alternatively, hover over the desired category in the Categories & Articles section, click the More () icon, and select Rename to edit the category name.

  4. Enter the new category name and click Update.

NOTE

Renaming the category or subcategory does not impact the category slug.

Renaming a category in the Knowledge base portal


Moving a category

You can move a category or subcategory across workspaces. All subcategories and articles within the category will also be moved when you perform the Move operation.

There are five ways to move a category in the Knowledge base portal:

  1. Method 1: Using the drag and drop () icon in the Categories & Articles section.

  2. Method 2: Using the More () icon in the Categories & Articles section.

  3. Method 3: Using the More () icon in the Folder/Index category.

  4. Method 4: Moving multiple articles/categories in the Folder/Index category.

  5. Method 5: Moving a specific article/category in the Folder/Index category.

User interface showing options for managing Move options in the Knowledge base portal.

To move a category using the drag and drop () icon in the Categories & Articles section:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category.

    The drag and drop () icon will appear.

  3. Hold and drag the category to the appropriate location.

NOTE

  • You cannot move a root-level category into its subcategory.

  • Drag and drop () icon allows moving categories only within the same workspace.

From the Categories & Articles, you can move a category within or across workspaces:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category or subcategory in the left navigation pane.

    The More () icon will appear.

  3. Click the More () icon and select the Move () icon.

  4. In the Move category panel, perform the following:

    • Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    • Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    • Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Move.

You can move a Folder/Index category using the More () option in it:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Click the More () icon and select the Move () icon.

  4. In the Move category panel, perform the following:

    • Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    • Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    • Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Move.

To move multiple articles/sub categories within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Select the checkboxes for the appropriate articles and subcategories.

  4. Click the Move () icon.

    In the Move category panel, perform the following:

    1. Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    2. Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    3. Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Move.

To move a specific article/sub category within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Hover over the desired article/sub category.

    The More () icon will appear.

  4. Click the More () icon and Click the Move () icon.

    In the Move category panel, perform the following:

    1. Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    2. Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    3. Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Move.

Screenshot of Moving category in Document360


Cloning a category

Clone categories are exact copies of the content created as new articles. You can clone the categories within or across workspaces.

There are three ways to clone a category in the Knowledge base portal:

  1. Method 1: Using the More () icon in the Categories & Articles section.

  2. Method 2: Using the More () icon in the Folder/Index category.

  3. Method 3: Cloning a specific article/sub category within a Folder/Index category.

Document360 interface showing options to manage clone options in the Knowledge base portal.

From the Categories & Articles section, you can clone a category within or across workspaces:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Hover over the desired category or subcategory in the left navigation pane.

    The More () icon will appear.

  3. Click the More () icon and select the Clone () icon.

  4. In the Clone category panel, perform the following:

    1. Name: Enter the name for the cloning category.

    2. Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    3. Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    4. Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Clone.

You can clone a Folder/Index category using the More () option in it:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Click the More () icon and select the Clone () icon.

  4. In the Clone category panel, perform the following:

    1. Name: Enter the name for the cloning category.

    2. Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    3. Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    4. Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Move.

To move a specific article/sub category within a specific Folder/Index category:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Go to the desired Folder/Index category.

  3. Hover over the desired article/subcategory.

    The More () icon will appear.

  4. Click the More () icon and select the Clone () icon.

    In the Clone category panel, perform the following:

    1. Name: Enter the name for the cloning category.

    2. Workspace: Select the desired workspace from the dropdown. Click Reset to assign it under the main workspace.

    3. Category: Select an existing category from the selected workspace. Click Reset to assign it under the root category.

    4. Auto update referenced links: Select this checkbox to ensure links in the article content are updated based on the destination workspace/category.

  5. Click Clone.

Cloning a category in Document360 with workspace and category options displayed.

NOTE

Security restrictions will be applied based on the destination workspaces/categories.


Starring a category

If you frequently use certain categories in your documentation, you can move them to Starred for quick and easy access. This feature functions like a favorites section and is available only in the Knowledge base portal.

NOTE

You can star categories, subcategories, and articles.

To add a category to Starred, follow these steps:

  1. Navigate to Documentation () in the Knowledge base portal.

  2. Select the desired category.

  3. Click the Starred () icon next to the category title.

    Alternatively, hover over a subcategory in the Folder/Index overview and click the Starred () icon.

  4. For a page category type, click the Starred () icon near the category title.

Document360 interface showing how to add a star a category in the Knowledge base portal.

You can remove a Starred categories in two ways:

Method 1: Direct removal

Method 2: Removing from the Starred () section

To remove a starred category directly from the categories, follow the steps below:

  1. Navigate to the desired category or subcategory in the Folder/Index overview page.

  2. Click the Starred () icon next to the category or subcategory title to unstar it.

To remove a Starred categories in the Starred () section:

  1. Navigate to Documentation () > Starred () in the Knowledge base portal.

    The Starred () page will appear, displaying a list of starred categories.

  2. Select the checkboxes next to the categories you want to remove.

  3. Click the Remove from starred option.

Document360 interface showing how to remove a star a category in the Knowledge base portal.

NOTE

When the category filter is applied to the starred items, you cannot view the article status for starred folders or index categories. This is because the starred articles are treated as independent items and are not associated with the category filter. However, only page categories will display the article status.


FAQs

What types of categories can I create?

You can create categories of type Folder, Index, Page, or GitHub.

Is there a limit to the number of categories I can create?

Yes, you can create up to 1,000 categories per workspace.

Can I create subcategories under a main category?

Yes, you can create up to seven levels of categories, including one root category and six subcategory levels.

What is the character limit for the article or category title?

The character limit for article or category titles is 150, including spaces.

Can I change the category icon to an emoji?

Yes, you can change the icon for Folder or Index type categories or subcategories to an emoji.

Is there a way to remove the emoji and revert to the folder icon?

Yes, you can click the 🚫 icon in the emoji popup window to remove the emoji and revert to the folder icon.

Do emoji styles vary by browser?

Yes, some emoji styles may vary by browser.

What is the purpose of hiding a category in Document360?

Hiding a category restricts access to certain information, making it visible only to team accounts while keeping it hidden from the Knowledge base site.

How can I identify hidden categories in Document360?

Hidden categories are indicated by a strikethrough in the categories list in the Documentation () section.

Can I hide multiple subcategories at once?

Yes, in Folder/Index type categories, you can hide multiple subcategories under the same parent category simultaneously by selecting the desired subcategories and clicking Hide ().

Is it possible to hide a category after it has been published?

Yes, you can hide a category even after it has been published by navigating to the Categories & Articles section and selecting the Hide () option.

NOTE

When you hide a category or subcategory, all its subcategories and articles will also be hidden.

Can I move a category across workspaces?

Yes, you can move a category between workspaces.

Does moving a category also move its subcategories and articles?

Yes, moving a category will also move its subcategories and articles to the desired location.

Can I move a root-level category into its subcategory?

No, you cannot move the root-level category into its subcategory.

Are there any security restrictions when moving categories?

Yes, security restrictions will be applied based on the destination workspaces/categories.

What are cloned categories?

Cloned categories are exact copies of the content created as new articles.

Can I clone categories across different workspaces?

Yes, you can clone categories within or across workspaces.

Is it possible to create new categories or articles within a cloned category?

Yes, you can create new categories or articles within a cloned category.

Can I change the type of a cloned category after it has been created?

Can I change the type of a cloned category after it has been created?

What is the purpose of starring categories in the Knowledge base portal?

Starring categories allows you to easily access frequently used categories, similar to a favorites section.

Is it possible to remove multiple categories from 'Starred' at once?

Yes, you can remove multiple categories from 'Starred' at once from the Starred () page.

How long are deleted categories available in the recycle bin?

Deleted categories will be available in the recycle bin for 30 days.

Does renaming a category update its slug?

No, renaming a category or article does not automatically update its slug. You must manually update the slug if required.

What are some best practices for naming categories?

Best practices include clarity and simplicity, consistent formatting, reader-centric language, avoiding repetition, logical hierarchy, keyword optimization, avoiding abbreviations, considering scalability, and ensuring contextual relevance.