Skip to main content
Version: 2026.05

Lineage

Experimental feature

Resource lineage is off by default. Enable it in Application settings → Experimental FeaturesResource lineage. The toggle is per-user and persists in your browser. See Settings.

Lineage lets you trace how every model and artifact in a system was produced and what it was used to produce. The complete set of parent/child relationships across a system is its lineage graph.

Use lineage to answer questions like:

  • Which design files and simulation results led to the part that just failed in production?
  • For a multi-step workflow, what did each step produce and which downstream steps consumed it?
  • Which validation results map back to which lines of a requirements document?

Concepts

  • Resource — any model or artifact stored in a system.
  • Parent — a resource that was used to generate another resource.
  • Child — a resource that was generated from another resource.
  • Lineage graph — the complete set of parent/child relationships among the resources in a system, in both directions from any starting point.

Enable Lineage

Once Resource lineage is enabled, a Lineage tab appears on file detail pages.

The toggle is per-user and is remembered in your browser.

Where Lineage Comes From

Resources become connected through lineage in two ways:

  • Automatically from jobs. When a job runs, its outputs are linked to the input files it consumed. No action is required from you — the relationship is recorded as part of the job's execution.

View Lineage for a Resource

  1. Open any model or artifact in a system.
  2. Open the Lineage view from the resource page.
  3. The graph centers on the selected resource and expands outward:
    • Parents are shown upstream of the resource.
    • Children are shown downstream of the resource.
  4. Click any node to navigate to that resource. From there you can open its lineage view to continue exploring.

Lineage and Jobs

When a job completes, its output resources are automatically related to the input files of the job. Workflows run through Istari Digital build up lineage without any extra steps:

  • Run a job — outputs are linked to inputs.
  • Chain jobs together — each step's outputs become parents of the next step's outputs.
  • View any resource's lineage to see the full execution graph that produced it.

See Jobs and Automation for more on running and reviewing jobs.

Sharing Lineage

When you share a system, collaborators with access to the underlying resources see the same lineage you do. File-level permissions still apply — users without access to a particular resource see it represented in the graph with limited information, the same way they would in the rest of the system.

See Sharing and Access Control for sharing details.