Importing dashboards

You can import dashboards from other IBM® API Connect users for use, or you can import dashboards from another Catalog on your system. If Spaces are enabled in a Catalog, you can also import dashboards from a Space.

Dashboards can be imported from .json files that contain one or more exported dashboard definitions.

Note: JSON files that contain a combination of exported visualizations and dashboards can also be imported as described in the following steps.

Before you begin

To import dashboards, you must either be the owner of the API provider organization, or be assigned a role that has the Analytics > Manage permission for the selected Catalog or Space. If you import a dashboard into a Catalog, the analytics data is scoped at the Catalog level, and if imported into a Space, the data is scoped to that Space. For information about enabling Spaces in a new or existing Catalog, see Creating and configuring Catalogs and Enabling Spaces in a Catalog. For more information about assigning Catalog or Space permissions to a role, see Managing Catalog membership and Managing Space membership.


To import one or more dashboards, complete the following steps:

  1. If you are not already in the Dashboard application, select Dashboard to view the list of available dashboards.
    The list of saved dashboards is displayed.
  2. Select Import.
  3. Navigate to the location where the .json file is stored and select the file to import it. If the file contains any dashboards that will overwrite existing ones on your system, new dashboards will be created even if they are duplicates.
    Remember that you cannot overwrite a default dashboard. If an imported dashboard has the same name as a default dashboard, it is saved with the same name but identified with a tag based on the whether it is a Catalog or Space dashboard.

    All dashboards in the .json file are added as individual objects to the Dashboards tab.