> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs describe Speckle as it works today, including everything released in 2026.9. Treat page content as current unless the page or section says it applies only to versions published before 2026.9.
> Content scoped to versions published before 2026.9 (the object graph and root object, Proxies, Receive2, operations.receive, object.children) applies only to model versions in that earlier data format. For versions published in 2026.9, answer from the Object model pages and the SDK migration guides.
> The What's new pages summarise what changed in 2026.9 and link to the page that documents each change. Answer from the linked page rather than from the summary. Legacy (v2) connectors are retired; send questions about them to the community help forum.
> Match guidance to the customer's deployment, model data format, connector, plan and permissions. Self-hosted servers on a release before 2026.9 and compatibility-mode workflows follow the Compatibility mode page. If an unknown version or data format changes the answer, ask one focused question; do not infer the deployment version from the date alone.

# Explore what an object is connected to

> Use the Explore node to find the level, room, host, or definition behind a Speckle Object in Grasshopper.

When you load a model you get the objects themselves: geometry, properties, materials. The model
also records how those objects relate to each other: which level a wall sits on, which room it is
in, which block definition an instance uses, what it is hosted on.

The **Explore** node surfaces those connections. Plug in any Speckle Object and it works out which
relationships exist for that object, then creates an output for each one.

<Note>
  Explore reads versions published from 2026.9 onwards, loaded with the current **Load** node.
  Versions published before 2026.9 do not record these connections, so there is nothing for Explore
  to show. See [Upgrade to 2026.9](/connectors/grasshopper/grasshopper#upgrade-to-2026-9).
</Note>

## Use Explore

<Steps>
  <Step title="Load a 2026.9 version">
    Load the model with the current **Load** node. You should see Speckle Objects on the
    **Collection** output.
  </Step>

  <Step title="Add the Explore node">
    Place an **Explore** node and wire in the thing you want to explore. Speckle Objects, Speckle
    Geometry, Block Instances, and Collections are all accepted.
  </Step>

  <Step title="Read the outputs">
    Explore creates an output for each relationship the model records for that object. You should
    see outputs such as level, rooms, or definition, depending on what you plugged in.
  </Step>
</Steps>

The set of outputs changes with what you plug in, so a Revit object and a Rhino object produce
different ones.

## What you can expect to find

The outputs depend on the source application, because different applications record different
things. Some examples:

* A wall gives you its level, the rooms it bounds, its type properties, and its sub-elements.
* A block instance gives you its definition, and the other placements using that same definition.
* A whole-model Collection gives you every level and its elevation.
* A structural member from ETABS gives you its analysis results.

<Info>
  Explore does not repeat what the object already carries. Material, colour, and Collection path are
  already set on the object when it loads, so they are not shown again here.
</Info>

## Work with analysis results

Structural results come out as several outputs of the same length, one per column of the results:
result type, load case, component, station, step, and value. Each row lines up across all of them.

Use the normal list tools to group them. **Sift Pattern** or **Member Index** on the load case
output pulls out just the results for one case.

Outputs only appear for the columns your model actually uses, so a result type without a station
does not produce a station output.

## Objects Explore cannot read

Some objects have no connections to show:

* Objects from a version published before 2026.9. This is by far the most common reason, because
  older versions do not record connections.
* Objects loaded with a **Load (legacy)** node, which is no longer supported. Switch to the current
  Load node: see [Upgrade to 2026.9](/connectors/grasshopper/grasshopper#upgrade-to-2026-9).
* Objects from inside a block definition, rather than a placed instance.
* Objects that were never loaded from Speckle.

In these cases Explore shows a remark on the canvas explaining why, and produces no outputs.

Republish the model with the current **Publish** node to create a version Explore can read.

## FAQ

<AccordionGroup>
  <Accordion title="Why does Explore say nothing is cached for a model that loaded correctly?">
    Explore reads a local copy of the model that your machine may have cleared. Reload the model and
    Explore picks up its connections again.
  </Accordion>

  <Accordion title="Why does Explore produce no outputs for my Revit model?">
    The usual cause is a version published before 2026.9, or a **Load (legacy)** node. Republish
    with the current Publish node, then load with the current Load node.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.