Importing visualizations

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

Visualizations can be imported from .json files that contain one or more exported visualization 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 visualizations, 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 visualization 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 visualizations, complete the following steps:

  1. From a dashboard, click Edit, then Add.
    The list of saved visualizations is displayed.
  2. Click Manage Visualizations to open the Manage Saved Objects page.

    This page contains separate tabs that show a listing of all your saved dashboards and visualizations, and the total counts. The Visualizations tab is displayed by default.

  3. Click the Import button.
  4. Navigate to the location where the .json file is stored and select the file to import it. If the file contains any visualizations that will overwrite existing ones on your system, new visualizations will be created even if they are duplicates.

    All visualizations in the .json file are added as individual objects to the Visualizations tab.

  5. Click the Close button to close the page and return to the dashboard.