Skip to main content
In Speckle, objects are the selectable elements inside your Speckle model. In Grasshopper you work with three kinds:
  • Speckle Objects: one element with one name, one set of properties, and one or more geometries, such as a wall or a beam.
  • Speckle Geometry: a single piece of geometry with its color and material.
  • Speckle Blocks: block instances and the block definitions they place.
Set an element’s name and properties on its Speckle Object, not on its geometry. A wall is one thing with one name and one set of properties, even when it has three meshes. If each mesh carried its own copy, summing a volume across the model would count that wall three times.
Passthrough nodes set static attributes on geometry. When you need per-element computed metadata or large nested graphs built from rules, use Enrich Speckle data in Grasshopper (Speckle.Sdk in a C# Script).

Speckle Objects

In Rhino and Grasshopper, a Speckle Object corresponds to a group of geometries with one name and one set of properties. Speckle Objects often represent BIM elements like walls, beams, and columns.
Speckle Objects are primarily used for data-based and computational workflows that often involve more complex objects from BIM, structural, and civil applications. You’ll find Speckle Objects in models from Revit, Navisworks, IFC, Archicad, Civil 3D, Tekla Structures, and ETABS. Property-only elements, such as Revit rooms, levels, and areas, also load as Speckle Objects.

Creating, inspecting, or modifying Speckle Objects

Use the Speckle Object passthrough node to create Speckle Objects or to add, modify, or inspect their attributes. Before 2026.9 this node was named Speckle Data Object. It is the same node with the same ports, so existing wiring is unchanged.
Speckle Object node
Inputs:
  1. Add a Speckle Object input only if you want to inspect or modify an existing Speckle Object, or are casting a Model object to assign all attributes during creation.
  2. Add a Geometries input list to set or change the geometries of the object. Speckle Geometry and Grasshopper geometry are accepted. Block Instances are not, because a Block Instance is already its own object.
  3. Add an optional Name input to set or change the name of the object.
  4. Add an optional Properties input to set or change the properties of the object.
Outputs:
  1. The Speckle Object output contains the resulting Speckle Object.
  2. The Geometries output contains the geometries used by (1).
  3. The Name output contains the name of (1).
  4. The Properties output contains the properties of (1).
  5. The Path output contains the full path of the Collection that (1) belongs to.
To find what a loaded Speckle Object is connected to, such as its level, rooms, or host, use the Explore node.

Baking and casting Speckle Objects

The Speckle Object param enables baking and casting to other native Grasshopper types. Baking and casting can be done from both the param node or the output param on another component. Baking Speckle Objects: On any Speckle Object param, right-click > select Bake to bake the Speckle Object into the current Rhino doc, with:
  • full path (parent Collections will be baked as parent layers)
  • geometries as a group
  • name (if any)
  • properties as user strings (if any)
Casting Speckle Objects: Speckle Objects can be piped into or from any of the following params, allowing you to use them interchangeably:
  • Grasshopper geometry (including hatches, blocks, and text). Casting to geometry only works if the Speckle Object has a single piece of geometry.
  • (Rhino 8+) Rhino model objects. Casting preserves name, color, material, user strings, and GUID. Casting to model objects only works if the Speckle Object has a single piece of geometry.

Geometry

In Rhino and Grasshopper, a Speckle Geometry corresponds to a single Rhino GeometryBase object, such as breps, curves, hatches, text, and block instances.
Speckle Geometry is primarily used for geometry-based workflows that do not involve more complex Objects such as pipes, walls, or beams. Speckle Geometry is typically used for workflows to and from Rhino, Grasshopper, Blender, AutoCAD, and SketchUp.

Creating, inspecting, or modifying Speckle Geometry

Since Speckle Geometry is nearly identical to native Grasshopper and Rhino geometry, you can use your Grasshopper geometry directly by casting into any Speckle component that has Speckle Geometry input. Use the Speckle Geometry passthrough node to set or inspect the color and material of your geometry. The node has no Name or Properties inputs: to give geometry a name or properties, wire it into a Speckle Object. Inputs:
  1. Add a Speckle Geometry input if you want to inspect or modify an existing Speckle Geometry, or are casting a Model object to assign all attributes during creation.
  2. Add a Geometry input to create a new Speckle Geometry or modify the geometry of (1).
  3. Add an optional Color input to set or change the color of the geometry.
  4. Add an optional Material input to set or change the material of the geometry.
Outputs:
  1. The Speckle Geometry output contains the resulting Speckle Geometry object.
  2. The Geometry output contains the geometry of (1).
  3. The Color output contains the color of (1).
  4. The Material output contains the material of (1).
  5. The Path output contains the full path of the Collection that (1) belongs to.
The 3D viewer does not draw colors set with the Color input yet, so that geometry shows as grey in the browser. The color is still published, and loading the model back into Grasshopper or Rhino keeps it. See 3D viewer.
A Speckle Geometry node placed in a script before 2026.9 now shows as Speckle Geometry (legacy), with its old Name and Properties inputs. It is no longer supported: replace it with a Speckle Object or the current Speckle Geometry node. See Upgrade to 2026.9.

Baking and casting Speckle Geometry

The Speckle Geometry param enables baking and casting to other native Grasshopper types. Baking and casting can be done from both the param node or the output param on another component. Baking Geometry: On any Speckle Geometry param, right-click > select Bake to bake the geometry into the current Rhino doc, with:
  • full path (parent Collections will be baked as parent layers)
  • name (if any)
  • color (if any)
  • material (if any)
  • properties as user strings (if any)
Casting Geometry: Speckle Geometry can be piped into or from any of the following params, allowing you to use them interchangeably:
  • Grasshopper geometry (including hatches, blocks, and text)
  • (Rhino 8+) Rhino model objects. Casting preserves name, color, material, user strings, and GUID.

Blocks

A Speckle Block Instance corresponds to a Rhino block, and a Speckle Block Definition corresponds to a Rhino block definition.
In Rhino and Grasshopper, blocks are instances of a block definition, which is comprised of geometry. Speckle Block Instances are a type of Speckle Geometry and are used as part of geometry-based workflows, typically to and from Rhino, Grasshopper, AutoCAD, and SketchUp.

Creating, inspecting, or modifying Speckle Blocks

Since Speckle Blocks are nearly identical to native Grasshopper and Rhino blocks, you can use your Grasshopper blocks directly by casting into any Speckle component that has Speckle Block Instance or Speckle Block Definition input. Use the Speckle Block Definition passthrough node for more advanced control of your block definitions, including adding, modifying, or inspecting attributes.
Node blockdefinition
Inputs:
  1. Add a Speckle Block Definition input only if you want to inspect or modify an existing Speckle Block Definition, or are casting a Model definition to assign all attributes during creation.
  2. Add a Name input to set or change the name of the block definition.
  3. Add a Geometries input list of Speckle Geometry to set or change the definition geometries.
Outputs:
  1. The Speckle Block Definition output contains the resulting Speckle Block Definition object.
  2. The Name output contains the name of (1).
  3. The Geometries output contains the definition geometries of (1).
Use the Speckle Block Instance passthrough node for more advanced control of your block instances, including adding, modifying, or inspecting attributes.
Node blockinstance
Inputs:
  1. Add a Speckle Block Instance input only if you want to inspect or modify an existing Speckle Block Instance, or are casting a Model instance to assign all attributes during creation.
  2. Add a Definition input to set or change the block definition of the instance.
  3. Add an optional Transform input to set or change the transform of the instance. Default is the identity transform.
  4. Add an optional Name input to set or change the name of the instance.
  5. Add an optional Properties input to set or change the properties of the instance.
  6. Add an optional Color input to set or change the color of the instance.
  7. Add an optional Material input to set or change the material of the instance.
Outputs:
  1. The Speckle Block Instance output contains the resulting Speckle Block Instance object.
  2. The Definition output contains the block definition used by (1).
  3. The Transform output contains the transformation of (1).
  4. The Name output contains the name of (1).
  5. The Properties output contains the properties of (1).
  6. The Color output contains the color of (1).
  7. The Material output contains the material of (1).

Baking and casting Speckle Blocks

The Speckle Block Instance param and Speckle Block Definition param enable baking and casting of blocks to other native Grasshopper types. Baking and casting can be done from both the param nodes or the output params on another component. Baking Blocks: On any Speckle Block Definition param, right-click > select Bake to bake the definition into the current Rhino doc, with each definition geometry containing:
  • name (if any)
  • color (if any)
  • material (if any)
  • properties as user strings (if any)
On any Speckle Block Instance param, right-click > select Bake to bake the instance into the current Rhino doc, with:
  • full path (parent Collections will be baked as parent layers)
  • definition (if it doesn’t already exist in the document)
  • name (if any)
  • color (if any)
  • material (if any)
  • properties as user strings (if any)
Casting Blocks: Speckle Block Definitions can be piped into or from any of the following params, allowing you to use them interchangeably:
  • (Rhino 8+) Rhino model block definitions. Casting preserves name of the block definition, and any color, material, user strings, and GUID of definition geometry.
Speckle Block Instances can be piped into or from any of the following params, allowing you to use them interchangeably:
  • (Rhino 8+) Rhino model block instances. Casting preserves name, color, material, user strings, and GUID.

Filtering objects by their attributes

You can filter a list of Speckle Objects, Speckle Geometry, or Block Instances by their attributes using the Filter Objects node.
Node filterobjects
Inputs:
  1. Add an Objects input of the Speckle objects you want to filter.
  2. Add an optional Name input to filter for objects with a matching name.
  3. Add an optional Property Key input to filter for objects containing a property with a matching key.
  4. Add an optional Property Value input to filter for objects containing a property with a matching value.
  5. Add an optional Material Name input to filter for objects using a material with a matching name.
  6. Zoom in and click on the + below the inputs to add an optional Application Id input to filter for objects with a matching application ID.
Each filter matches the exact value by default. Start the filter string with ? to match values that contain it, < for values that start with it, > for values that end with it, or ; to use a regular expression.
Outputs:
  1. The Objects output contains a list of all input Objects that meet the filter conditions.
  2. The Culled Objects output contains a list of all input Objects that did not meet the filter conditions.
Last modified on October 19, 2026