How do I group reports into categories in Cloud Reporting?
In Bold Reports® Cloud, you can create, open, update, and delete categories, and manage sharing permissions for them. Accessibility to categories depends on the user’s permissions.
Categories are displayed on the left side of the report listing page.

How to open a category
You open a category by clicking it in the left panel of the report listing page to view the reports grouped with it.

How to create a category
You create a category from the Publish dialog, the copy report dialog, or the + menu, and you need the Create All Categories permission. There are several ways to add a category, as follows:
- When publishing a designed report to the Bold Reports® Report Server, the New Category option will be available. For instructions on creating a category through the Publish dialog, see the Create Category section.
- Add a new category while copying a report from the context menu on the report listing page.

- Click the + icon in the toolbar, and then select Create Category.
Provide a name and description (optional) for the category and click Add.
The user who created the category is provided with
Read,Write,Deletepermissions for that specific category.
How to share a category
You share a category with other users or groups by setting its sharing permissions from the category context menu.
Steps to share a category
- Click Actions in the category list context menu and select Sharing Permissions.

- Click Manage Access.

- Choose the level of permission access, and then select the users or groups with whom you want to share the Category.

- Click Add to save the sharing permissions.
Only the user who has permission can share the category with other Report Server users.
Remove Category permission
A user with the required permissions can remove a shared category permission in the Manage Access dialog: select the remove option for the user or group, and then click Save.

How to pin a category
You pin a category for quick access by selecting Pin in the category context menu.
- Select Pin in the context menu of the category.

How to update a category
You update a category’s name and description by selecting Update from the category’s settings menu.
- Click the settings icon for the category.
- Select Update from the context menu.

- Make the necessary changes to the name or description, then click the Update button to save your changes.

How to delete a category
You delete a category that has no grouped reports by selecting Delete from the category’s settings menu.
- Click the settings icon in the category list.
- Select Delete.
A category that contains grouped reports cannot be deleted.
Frequently asked questions
Can I delete a category that still contains reports?
No. Cloud Reporting does not delete a category that contains grouped reports. Move the reports to another category or delete them first, then delete the category.
What permission do I need to create a category?
You need the Create All Categories permission. The user who creates a category gets Read, Write, and Delete permissions for that category.
How do I move a report to a different category?
Click Actions in the Reports grid context menu and select Move. See Move, copy and clone reports.
Can I create categories with the REST API?
Yes. Send a POST request to /api/site/{tenant-name}/v1.0/categories (AddCategory). The REST API Reference table on this page lists the other category endpoints.
REST API Reference
The following table lists the available APIs related to categories.
| Action | HTTP Method | Endpoint | Description |
|---|---|---|---|
| AddCategory | POST | /api/site/{tenant-name}/v1.0/categories | Adds a new category to the server. Category details must be passed as input. |
| UpdateCategory | PUT | /api/site/{tenant-name}/v1.0/categories | Updates the category on the server. Updated category details must be passed as input. |
| GetCategory | GET | /api/site/{tenant-name}/v1.0/items | Returns the list of categories for the current user. ItemType should be Category. |
| IsCategoryNameExists | POST | /api/site/{tenant-name}/v1.0/items/is-name-exists | Returns an item's existence, whether the given category name already exists or not on the server. Category name and ItemType as Category should be passed in the request body. |
| GetCategoryDetail | GET | /api/site/{tenant-name}/v1.0/items/{id} | Returns the specified category details from the server. Category item ID should be passed in the path parameter. |
| DeleteCategory | DELETE | /api/site/{tenant-name}/v1.0/items/{id} | Deletes the specified category from the server. Category item ID should be passed in the path parameter. |