Speckle automatically tracks every change you make to your models. Each time you send data, a new version is created. This allows you to review the entire history of your model, compare changes over time, and revert to earlier versions if needed.

​
How It Works

Whenever you send data from a Speckle-enabled application (like Revit, Rhino, or Grasshopper), Speckle stores that data as a new version. Each version is:

  • Timestamped
  • Tagged with metadata (e.g. message, source application, sender)
  • Linked to previous versions, allowing for complete traceability and version comparison

Behind the scenes, Speckle breaks your model down into individual objects (such as walls, floors, meshes, or parameter sets) and gives each object a unique identifier.

Learn more about versions here.

​
To compare two versions:

  1. Open the Models tab on the left side of your screen.

  2. Click on the latest version to expand the version list and view all available commits.

  3. Browse the list of commits and identify the version you want to compare. Then click View Changes to see a detailed comparison.


​
Benefits

  • Change Awareness: Understand how your model has evolved over time.
  • Design Iteration: Explore different design options across models without overwriting previous work.
  • Collaboration: See who made what changes and when, helping teams stay in sync.
  • Recovery: Roll back to a previous version if something goes wrong.
    Note: Recovery is only supported in Rhino, Autocad and Sketchup connectors.

​
Tips

  • Use meaningful messages when sending data to make version tracking more readable.
  • Create models for separate project phases or design options to keep changes organized.
  • Use the diffing feature to compare versions and spot differences in geometry, parameters, or structure.