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. Category setting options

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. Open already created categories

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:

  1. 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.
  2. Add a new category while copying a report from the context menu on the report listing page. Copy report dialog with the option to add a new category
  3. Click the + icon in the toolbar, and then select Create Category. Create category button Provide a name and description (optional) for the category and click Add. Add a new category for reports

    The user who created the category is provided with Read, Write, Delete permissions 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

  1. Click Actions in the category list context menu and select Sharing Permissions. Select Sharing Permissions option
  2. Click Manage Access. Set permissions to share a Category
  3. Choose the level of permission access, and then select the users or groups with whom you want to share the Category. Add permission to Category
  4. Click Add to save the sharing permissions. Add button that saves the category 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. Remove Permission

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. Pin Category

How to update a category

You update a category’s name and description by selecting Update from the category’s settings menu.

  1. Click the settings icon for the category.
  2. Select Update from the context menu. Click Update Category
  3. Make the necessary changes to the name or description, then click the Update button to save your changes. Update category name and description

How to delete a category

You delete a category that has no grouped reports by selecting Delete from the category’s settings menu.

  1. Click the settings icon in the category list.
  2. Select Delete. Delete created category

    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.