BIM 42

Managing linked worksets

A pretty powerful function in Revit is the ability to manage worksets in a linked Revit file.


In the Manage Link window, selecting the Manage Worksets open a list of user worksets in the linked file. These linked worksets can be opened or closed through the same interface.


It is a project setting, so elements in the closed workset will be hidden everywhere in our host model.

It allow us to load only the part of the linked project that really interesting us. For example, as a mechanical engineer, I generally don’t need to display furniture from the architectural model. Closing the related workset can save me significant loading time.

The most common application of this feature is to hide linked grids and references planes.When new workset are created, every level and grid goes into the “Shared Levels and Grids” default workset. This behavior should not be changed, since it allows us to easily hide linked levels and grids in our current model.

Before closing linked "Shared Levels and Grids" workset

After closing linked "Shared Levels and Grids" workset

I also place reference planes and scope boxes in this workset, to be able to hide them as easily. But selecting all reference planes and scope boxes of a model to place them in the correct workset can a tedious business. To change this, I wrote a few line of code for set up every Scope Box, and Reference plane to the correct workset :

public void SetGridWorkset()
  Document doc = this.ActiveUIDocument.Document;

  //Select the shared grid workset
  IList<Workset> worksetList =
    new FilteredWorksetCollector(doc)
  int sharedGridWorksetId=0;

  foreach (Workset workset in worksetList) {
    if (workset.Name.Contains("Shared Levels and Grids"))
      sharedGridWorksetId = workset.Id.IntegerValue;

  if( sharedGridWorksetId == 0 ) return;

  //Reference planes
  List<Element> elements =
    new FilteredElementCollector(doc)
  //Scope box
  List<Element> scopeBoxes =
    new FilteredElementCollector(doc)

  using (Transaction tx = new Transaction(doc)) {
    tx.Start("Change Workset");

    foreach (Element e in elements) {

      //Retrive workset parameter
      Parameter wsparam =
        e.get_Parameter(BuiltInParameter.ELEM_PARTITION_PARAM );
      if( wsparam == null ) continue;

      //set workset to Shared Levels and Grids


This piece of code is inspired from the work of Jeremy Tamick, available here, thanks to him.

This blog is maintained by Simon Moreau