---
title: View relationships in graph form
description: The Identity Relationships widget gives a visual display of the relationships between objects.
component: pingidm
version: 8.1
page_id: pingidm:objects-guide:view-relationships-ui
canonical_url: https://docs.pingidentity.com/pingidm/8.1/objects-guide/view-relationships-ui.html
keywords: ["Data Object Model", "Relationships", "Dashboard"]
section_ids:
  add_the_identity_relationships_widget_to_a_dashboard: Add the Identity Relationships widget to a dashboard
  use_the_identity_relationships_widget: Use the Identity Relationships widget
---

# View relationships in graph form

|   |                                                                                                                                                                                          |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | Widgets are deprecated and will be removed in a future release of IDM. For more information, refer to [Deprecation](../release-notes/deprecated-functionality.html#deprecation-widgets). |

The *Identity Relationships widget* gives a visual display of the relationships between objects.

## Add the Identity Relationships widget to a dashboard

This widget is not displayed on any dashboard by default. You can add it as follows:

1. Log in to the admin UI.

2. From the navigation bar, click Dashboards, and select a dashboard. Alternatively, [create a dashboard](../setup-guide/managing-dashboards.html#to-create-a-dashboard).

3. On the applicable dashboard page, click Add Widget.

4. In the Add Widget window, click the drop-down menu, scroll down to the Utilities item, and select Identity Relationships.

5. Click [icon: cog, set=fas]Settings, and make selections from the following drop-down menus:

   * Widget Size—Select from Small, Medium, or Large.

   * Chart Type:

     * Collapsible Tree Layout:

       ![relationships-collapsible](_images/relationships-collapsible.png)

     * Radial Layout:

       ![relationships-radial](_images/relationships-radial.png)

   * Default Object—Select the object for which to display relationships; for example, User.

   * Display/Search Property—Select one or more properties to search on the default object that will be displayed in the widget; for example, userName and city.

6. Optionally, click [icon: eye, set=fas]Preview to view a widget preview.

7. Click Add to add the widget to the dashboard.

## Use the Identity Relationships widget

To use the Identity Relationships widget:

1. Select a user within the widget.

   The following example shows relationships for imartinez, including Manager and Direct Reports:

   ![relationships-graph](_images/relationships-graph.png)

2. You can interact with the graph in multiple ways:

   * Select or clear Data Types to filter information.

   * Click and drag the graph for a different view.

   * Double-click a user to view their profile.