> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/command/prior-v26.0/features/relationship-editor/relationship-editor-options.md).

# Relationship Options

{% hint style="warning" %}
**Previous release**

This page describes the release before v26.0, which used the classic ServiceNow forms and lists. It is kept for reference. For the current version, see [Relationship Editor](https://docs.ins-pi.com/command/features/relationship-editor.md).
{% endhint %}

Additional features of the Relationship Editor allow you to customize the application's appearance, adjust how your diagrams are displayed, and share diagrams.

## Reposition the Sidebar

1. Move your cursor to the upper section of the sidebar, labeled "Relationship Editor".
2. Click on this section and drag the sidebar to your preferred location.

   The sidebar can be placed on the left side of the window or float anywhere inside it.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-68239dd7b2f80bd44b1cb52c4537d880f52bcf80%2F76b69ef-upmx-add_features1.gif?alt=media)

## Legend

Select the Legend button to toggle the UI elements' labels on and off.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-af195285450fb2bf5de63fc8f1ccd2f7794d00ae%2F05c1864-upmx-add_features6.png?alt=media)

## Filter Relationships

The filter view updates as you add relationships between elements. It shows the tables of any elements you have connected to the primary element in the Relationship Editor. A number appears to the right of each table, indicating how many relationships you have created for that table so far.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-ffff111a44910abe5aa1719b567e30e9ce514845%2F18fec75-upmx-add_features2.png?alt=media)

If you want to filter out all elements from a table in the diagram:

* Uncheck the **checkbox** to the left of the table.

If you want to hide all connections:

* Select **Hide All**.

If you want to reveal hidden connections:

* Select **Show All**.

## Reorient Relationship View

By default, the Relationship Editor displays relationships in a horizontal orientation. You may prefer a vertical view. To switch to a vertical view:

* Select the **arrows icon** in the options panel.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-012547e3ae82b198d93347f1bc1028fb75078088%2F5d96a5c-upmx-add_features4.png?alt=media)

To toggle back to a horizontal view:

* Select the **arrows icon** in the options panel.

## Share Diagrams

There are two ways to share your relationship diagram. To share it as a PNG file:

* Select the image icon in the options panel.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-e09bdb439bb254b9e2e714c32d1c47916219b8dd%2Fc5f748c-upmx-add_features3.png?alt=media)

This triggers a PNG copy of the diagram to download to your computer.

To share a read-only link to the diagram:

* Select the share icon in the options panel.

![](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-25dbc87452dab372b098eb02921833f4d52c38e8%2Fe5ae349-upmx-add_features5.png?alt=media)

{% hint style="warning" %}
**Read-Only Link Visibility**

Only colleagues in your organization with access to ServiceNow and permission to view the data on which the relationship is based can view diagrams in the Relationship Editor.
{% endhint %}

{% hint style="warning" %}
**PNG vs. Linked Images**

The PNG image shows all relationships added, including those not yet committed. However, the linked image only shows committed changes.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ins-pi.com/command/prior-v26.0/features/relationship-editor/relationship-editor-options.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
