Skip to main content
Relationship graphs give you a visual map of how an entity connects to the rest of your Cortex catalog. Instead of loading your whole catalog at once, you start from a single entity and expand outward, one relationship at a time. This makes it easier to answer questions like “Which domain does this service belong to?”, “Who owns it, and where does that ownership come from?”, and “What does it depend on?” A graph can show these kinds of relationships:
  • Dependencies - How entities call or depend on one another.
  • Domain hierarchy - Which domains an entity belongs to, and what each domain contains.
  • Ownership - Which teams own an entity, and which entities a team owns.
  • Custom relationship types - Any relationship types your workspace defines. If a custom relationship type doesn’t name its parents or children, the graph labels them as sources and destinations.
Relationship graphs show up to 300 nodes. Once a graph reaches 300, you can’t expand any more nodes. To keep exploring, focus the graph on a different node. This clears the nodes you no longer need so you can continue from the new node.

Viewing the relationship graph

To open a relationship graph, expand Tools in the main sidebar, then select Relationship graphs.
The Relationship graph view.
You can also open the graph from any entity. On the entity’s details page or its Relationships page, click View in relationship graph. The graph opens with that entity already selected as the starting entity.

Choosing a starting entity

Pick the entity you want to explore:
  • Select an entity from the Select entity dropdown. You can search by name, filter the list by entity type, or turn on Show archived to include archived entities.
  • Or, select an entity from the Owned by your team or Owned by you lists.
Cortex places that entity in the graph and loads one level of connections above and below it. To start over from a different entity, use the entity dropdown in the upper-left corner of the page, or click the X next to the entity’s name to clear the graph. To start from an entity that’s already in the graph, select it and click Focus graph here.

Reading the graph

Each node in the graph is an entity, labeled with its name, its tag, and an icon for its entity type.
  • Relationships legend - The Relationships legend in the upper-left corner lists each relationship type currently in the graph, next to the color used for its edges and count badges. To save space, you can collapse the legend so it shows only the colored dots.
    The Relationships legend in the Relationship graph view.
  • Count badges - A badge on the top edge of a node shows how many hidden connections sit above that entity, such as the domains it belongs to or the teams that own it. A badge on the bottom edge shows how many hidden connections sit below it, such as the entities a team owns or the services an entity calls. The badge color matches the relationship type.
    Count badges in the Relationship graph view.
  • Edge styles - The legend in the bottom-left corner explains the line styles:
    • Thin solid line - A hierarchy edge, colored by relationship type.
    • Thick solid line - Owners inherited and appended from a parent entity.
    • Dashed line - Owners inherited as a fallback from a parent entity.
    Edge styles in the Relationship graph view.
For more on appended and fallback owners, see Ownership inheritance.

Expanding and collapsing a graph

A graph only shows what you choose to expand, so you can follow one path at a time without losing your place.
  • Expand a node - Click a count badge to load the hidden connections. If the entity has connections from more than one relationship type, a menu opens where you can choose which types to show. Select the checkboxes for the types you want, or click Add all or Remove all.
  • Collapse a node - Click the collapse icon (-) on a node to hide the parents or children you’ve expanded.

Inspecting an entity

Click any node to select it and open the Entity details side panel.
The entity side panel in the Relationship graph view.
From the side panel, you can:
  • Go to entity - Open the entity’s details page.
  • Focus graph here - Re-center the graph on the selected entity so it becomes the new starting point. You can also hover over a node and click the focus icon.
  • Manage relationships - The Relationships section lists each relationship type for the entity:
    • Click Add to load that relationship type into the graph, or Remove to hide it.
    • Expand a relationship type to see the related entities, such as Parents, Owners, or Owned. The count shows how many are in the graph out of the total, for example “1 of 3”. If only some of them are shown in the graph, click Add more to load the rest.
    • Click an entity in the list to focus the graph on it.
To close the side panel, click the side panel icon in its upper-right corner.

Searching the graph

Use the Search in graph field in the upper-right corner to find entities that are already in the graph. Cortex highlights the matching nodes and shows the number of matches. The field uses the same syntax as catalog search, so you can combine terms with AND, OR, and NOT, or use field operators like owner: and group:. To find an entity that isn’t in the graph yet, use the entity dropdown in the upper-left corner instead.
The search option on the Relationship graph view.

Filtering the graph

Click Filter at the top to narrow down which entities appear in the graph.
  1. From the list on the left, click the field you want to filter by: AWS accounts, AWS regions, Domains, Entity types, Groups, Owners, or Teams.
  2. Choose the values to filter by. You can add more than one filter.
  3. Click Apply.
To clear all filters, open Filter and click Reset filters.

Choosing display options

Click Display at the top, then turn Show archived on or off to include or exclude archived entities. Click Reset display to go back to the default settings.

Moving around the graph

Use the controls in the bottom-right corner to zoom in and out, or click the fit view icon to fit the graph to the screen. The mini-map above the zoom controls shows where you are in a larger graph.

Sharing or syncing from the graph

Use the share and sync icons in the upper-right corner of the page.
The share and sync icons in the Relationship graph view.
  • Share - Copy a link to the current graph view, including the starting entity and the nodes you’ve expanded.
  • Sync dependencies - Users with the Enable Entity Dependency Discovery permission can manually sync dependencies. Cortex automatically syncs AWS dependencies every day at 8:00 a.m. UTC. All other dependencies sync at 12:00 a.m. UTC.
Last modified on November 16, 2026