Skip to content

Releases: Nice3point/RevitExtensions

2027.0.0-preview.1.20260120

20 Jan 21:09
@github-actions github-actions
2027.0.0-preview.1.20260120
0e27705

Choose a tag to compare

View all tags
2027.0.0-preview.1.20260120 Pre-release
Pre-release

This update focuses on improved API design through C# 14 extension methods syntax, .NET 10 support, Revit 2027 support, and extensive ElementId overloads.

Breaking changes

Extension Methods

The following boolean methods have been converted to properties for improved syntax and consistency with modern C# conventions:

  • IsAnalyticalElement: Changed from method to property
  • IsPhysicalElement: Changed from method to property
  • AreGlobalParametersAllowed: Changed from method to property
  • IsBuiltInParameter (ForgeTypeId): Changed from method to property
  • IsBuiltInParameter (Parameter): Changed from method to property
  • IsBuiltInGroup: Changed from method to property
  • HasOpenConnector: Changed from method to property
  • IsAllowedForSolidCut: Changed from method to property
  • IsElementFromAppropriateContext: Changed from method to property
  • IsValidForTessellation: Changed from method to property
  • IsSpec: Changed from method to property
  • IsValidDataType: Changed from method to property
  • IsSymbol: Changed from method to property
  • IsUnit: Changed from method to property
  • IsMeasurableSpec: Changed from method to property

Renamed Methods (Revit API naming consistency):

  • CanDeleteElement: Renamed to CanBeDeleted (passive voice pattern)
  • CanMirrorElement: Renamed to CanBeMirrored (passive voice pattern)
  • CanMirrorElements: Renamed to CanBeMirrored (passive voice pattern)
  • CanConvertToFaceHostBased: Renamed to CanBeConvertedToFaceHostBased (passive voice pattern)

Obsolete methods with auto-conversion:

Old method names are marked as [Obsolete] with [CodeTemplate] attributes for automatic IDE conversion to new names.

Migration examples:

// Properties (old → new, auto-conversion is not available because of the same name)
if (element.IsAnalyticalElement())  // Old
if (element.IsAnalyticalElement)    // New

// Renamed methods (old → new, auto-conversion available)
element.CanDeleteElement();              // Old, IDE suggests: element.CanBeDeleted()
element.CanMirrorElement();              // Old, IDE suggests: element.CanBeMirrored()
family.CanConvertToFaceHostBased();      // Old, IDE suggests: family.CanBeConvertedToFaceHostBased()

New Features

ElementId Extension Overloads

Added comprehensive ElementId overloads for all extension methods that work with element.Document and element.Id.
This allows working directly with ElementId when you don't have the Element instance.

Utils Extensions:

  • DocumentValidationExtensions

    • elementId.CanBeDeleted(Document document)

  • ElementTransformUtilsExtensions

    • elementId.CanBeMirrored(Document document)
    • elementId.Copy(Document document, XYZ vector)
    • elementId.Copy(Document document, double deltaX, double deltaY, double deltaZ)
    • elementId.Mirror(Document document, Plane plane)
    • elementId.Move(Document document, double deltaX, double deltaY, double deltaZ)
    • elementId.Move(Document document, XYZ vector)
    • elementId.Rotate(Document document, Line axis, double angle)

  • FamilyUtilsExtensions

    • elementId.CanBeConvertedToFaceHostBased(Document document)
    • elementId.ConvertToFaceHostBased(Document document)

  • WorksharingUtilsExtensions

    • elementId.GetCheckoutStatus(Document document)
    • elementId.GetCheckoutStatus(Document document, out string owner)
    • elementId.GetWorksharingTooltipInfo(Document document)
    • elementId.GetModelUpdatesStatus(Document document)

Manager Extensions:

  • AnalyticalToPhysicalAssociationManagerExtensions

    • elementId.IsAnalyticalElement(Document document)
    • elementId.IsPhysicalElement(Document document)

  • GlobalParametersManagerExtensions

    • elementId.MoveGlobalParameterUpOrder(Document document)
    • elementId.MoveGlobalParameterDownOrder(Document document)

Other Extensions:

  • CategoryExtensions

    • builtInCategory.ToCategory(Document document)

  • ParameterExtensions

    • builtInParameter.ToParameter(Document document)

Usage examples:

// Work with ElementId directly without Element instance
ElementId elementId = /* ... */;

// Validation
if (elementId.CanBeDeleted(document))
{
    document.Delete(elementId);
}

// Transformations
elementId.Copy(document, new XYZ(10, 0, 0));
elementId.Move(document, 5, 5, 0);
elementId.Mirror(document, plane);
elementId.Rotate(document, axis, angle);

// Worksharing
var status = elementId.GetCheckoutStatus(document);
var tooltipInfo = elementId.GetWorksharingTooltipInfo(document);

// Family operations
if (familyId.CanBeConvertedToFaceHostBased(document))
{
    familyId.ConvertToFaceHostBased(document);
}

// Global parameters
globalParamId.MoveGlobalParameterUpOrder(document);

// Built-in conversions
Category category = BuiltInCategory.OST_Walls.ToCategory(document);
Parameter parameter = BuiltInParameter.WALL_ATTR_ROOM_BOUNDING.ToParameter(document);

Improvements

  • Revit 2019 support by @ZedMoster in #13
  • SDK Update: Updated to stable .NET 10 SDK
  • Documentation: Updated parameter descriptions and variable names to align with C# 14 syntax
  • Build System: Migration from Nuke to ModularPipilines
  • API Consistency: Renamed Can* methods to follow Revit API passive voice pattern (CanBe*)

Full changelog: 2026.0.2-preview.1.20251113...2027.0.0-preview.1.20260120

Contributors

ZedMoster
Loading

2026.0.2-preview.2.20260118

19 Jan 08:42
@github-actions github-actions
2026.0.2-preview.2.20260118
bebab66

Choose a tag to compare

View all tags
2026.0.2-preview.2.20260118 Pre-release
Pre-release

This update focuses on improved API design through C# 14 extension methods syntax, .NET 10 support, and extensive ElementId overloads.

Breaking changes

Extension Methods

The following boolean methods have been converted to properties for improved syntax and consistency with modern C# conventions:

  • IsAnalyticalElement: Changed from method to property
  • IsPhysicalElement: Changed from method to property
  • AreGlobalParametersAllowed: Changed from method to property
  • IsBuiltInParameter (ForgeTypeId): Changed from method to property
  • IsBuiltInParameter (Parameter): Changed from method to property
  • IsBuiltInGroup: Changed from method to property
  • HasOpenConnector: Changed from method to property
  • IsAllowedForSolidCut: Changed from method to property
  • IsElementFromAppropriateContext: Changed from method to property
  • IsValidForTessellation: Changed from method to property
  • IsSpec: Changed from method to property
  • IsValidDataType: Changed from method to property
  • IsSymbol: Changed from method to property
  • IsUnit: Changed from method to property
  • IsMeasurableSpec: Changed from method to property

Renamed Methods (Revit API naming consistency):

  • CanDeleteElement: Renamed to CanBeDeleted (passive voice pattern)
  • CanMirrorElement: Renamed to CanBeMirrored (passive voice pattern)
  • CanMirrorElements: Renamed to CanBeMirrored (passive voice pattern)
  • CanConvertToFaceHostBased: Renamed to CanBeConvertedToFaceHostBased (passive voice pattern)

Obsolete methods with auto-conversion:

Old method names are marked as [Obsolete] with [CodeTemplate] attributes for automatic IDE conversion to new names.

Migration examples:

// Properties (old → new, auto-conversion is not available because of the same name)
if (element.IsAnalyticalElement())  // Old
if (element.IsAnalyticalElement)    // New

// Renamed methods (old → new, auto-conversion available)
element.CanDeleteElement();              // Old, IDE suggests: element.CanBeDeleted()
element.CanMirrorElement();              // Old, IDE suggests: element.CanBeMirrored()
family.CanConvertToFaceHostBased();      // Old, IDE suggests: family.CanBeConvertedToFaceHostBased()

New Features

ElementId Extension Overloads

Added comprehensive ElementId overloads for all extension methods that work with element.Document and element.Id.
This allows working directly with ElementId when you don't have the Element instance.

Utils Extensions:

  • DocumentValidationExtensions

    • elementId.CanBeDeleted(Document document)

  • ElementTransformUtilsExtensions

    • elementId.CanBeMirrored(Document document)
    • elementId.Copy(Document document, XYZ vector)
    • elementId.Copy(Document document, double deltaX, double deltaY, double deltaZ)
    • elementId.Mirror(Document document, Plane plane)
    • elementId.Move(Document document, double deltaX, double deltaY, double deltaZ)
    • elementId.Move(Document document, XYZ vector)
    • elementId.Rotate(Document document, Line axis, double angle)

  • FamilyUtilsExtensions

    • elementId.CanBeConvertedToFaceHostBased(Document document)
    • elementId.ConvertToFaceHostBased(Document document)

  • WorksharingUtilsExtensions

    • elementId.GetCheckoutStatus(Document document)
    • elementId.GetCheckoutStatus(Document document, out string owner)
    • elementId.GetWorksharingTooltipInfo(Document document)
    • elementId.GetModelUpdatesStatus(Document document)

Manager Extensions:

  • AnalyticalToPhysicalAssociationManagerExtensions

    • elementId.IsAnalyticalElement(Document document)
    • elementId.IsPhysicalElement(Document document)

  • GlobalParametersManagerExtensions

    • elementId.MoveGlobalParameterUpOrder(Document document)
    • elementId.MoveGlobalParameterDownOrder(Document document)

Other Extensions:

  • CategoryExtensions

    • builtInCategory.ToCategory(Document document)

  • ParameterExtensions

    • builtInParameter.ToParameter(Document document)

Usage examples:

// Work with ElementId directly without Element instance
ElementId elementId = /* ... */;

// Validation
if (elementId.CanBeDeleted(document))
{
    document.Delete(elementId);
}

// Transformations
elementId.Copy(document, new XYZ(10, 0, 0));
elementId.Move(document, 5, 5, 0);
elementId.Mirror(document, plane);
elementId.Rotate(document, axis, angle);

// Worksharing
var status = elementId.GetCheckoutStatus(document);
var tooltipInfo = elementId.GetWorksharingTooltipInfo(document);

// Family operations
if (familyId.CanBeConvertedToFaceHostBased(document))
{
    familyId.ConvertToFaceHostBased(document);
}

// Global parameters
globalParamId.MoveGlobalParameterUpOrder(document);

// Built-in conversions
Category category = BuiltInCategory.OST_Walls.ToCategory(document);
Parameter parameter = BuiltInParameter.WALL_ATTR_ROOM_BOUNDING.ToParameter(document);

Improvements

  • Revit 2019 support by @ZedMoster in #13
  • SDK Update: Updated to stable .NET 10 SDK
  • Documentation: Updated parameter descriptions and variable names to align with C# 14 syntax
  • Build System: Migration from Nuke to ModularPipilines
  • API Consistency: Renamed Can* methods to follow Revit API passive voice pattern (CanBe*)

Full changelog: 2026.0.1...2026.0.2-preview.2.20260118

Contributors

ZedMoster
Loading

2026.0.1

02 Apr 19:30
@github-actions github-actions
2026.0.1
ca3c210

Choose a tag to compare

View all tags
2026.0.1 Latest
Latest

This update focuses on increased utility class coverage, new extensions for global parameter management, for ForgeTypeId handling, advanced geometry extensions, and many-many more.

New Extensions

Ribbon Extensions

  • AddStackPanel: Adds a vertical stack panel to the specified Ribbon panel.
  • AddPushButton: Adds a PushButton to the vertical stack panel.
  • AddPullDownButton: Adds a PullDownButton to the vertical stack panel.
  • AddSplitButton: Adds a SplitButton to the vertical stack panel.
  • AddComboBox: Adds a ComboBox to the vertical stack panel.
  • AddTextBox: Adds a TextBox to the vertical stack panel.
  • AddLabel: Adds a text label to the vertical stack panel.
    verticalStack
  • RemovePanel: Removes RibbonPanel from the Revit ribbon.
  • SetBackground: Sets the RibbonPanel background color.
  • SetTitleBarBackground: Sets the RibbonPanel title bar background color.
  • SetSlideOutPanelBackground: Sets the slide-out panel background color for the target RibbonPanel.
  • SetToolTip: Sets the tooltip text for the PushButton.
  • SetLongDescription: Sets the extended tooltip description for the RibbonItem.
  • CreatePanel: Now works with internal panels. Panel can be added to the Modify, View, Manage and other tabs.
  • SetImage: Support for Light and Dark UI themes.
  • SetLargeImage: Support for Light and Dark UI themes.
  • AddShortcuts: Adds keyboard shortcuts to the RibbonButton.

ElementId Extensions

  • ToElements: Retrieves a collection of Elements associated with the specified ElementIds.
  • ToElements: Retrieves a collection of Elements associated with the specified ElementIds as the specified type T.
  • ToOrderedElements: Retrieves the Elements associated with the specified ElementIds in their original order.
  • ToOrderedElements: Retrieves the Elements associated with the specified ElementIds and casts them to the specified type T in their original order.

ElementId Transform Extensions

  • CanMirrorElements: Verifies whether a set of elements can be mirrored.
  • MirrorElements: Mirrors elements across a plane, with support for mirrored copies.
  • MoveElements: Moves elements according to a specified transformation.
  • RotateElements: Rotates elements around a given axis by a specified angle.
  • CopyElements: Copies elements between views or within the same document, with options for translation and transformation.

Geometry Extensions

  • Contains: Determines if a point or another bounding box is contained within the bounding box, with strict mode available for more precise containment checks.
  • Overlaps: Checks whether two bounding boxes overlap.
  • ComputeCentroid: Calculates the geometric center of a bounding box.
  • ComputeVertices: Returns the coordinates of the eight vertices of a bounding box.
  • ComputeVolume: Computes the volume enclosed by the bounding box.
  • ComputeSurfaceArea: Calculates the total surface area of the bounding box.

Parameters Extensions

  • IsBuiltInParameter: Verifies if a parameter is a built-in parameter.

Document Global Parameters Extensions

  • FindGlobalParameter: Locates a global parameter by name in the document.
  • GetAllGlobalParameters: Returns all global parameters in the document.
  • GetGlobalParametersOrdered: Retrieves ordered global parameters.
  • SortGlobalParameters: Sorts global parameters in the specified order.
  • MoveUpOrder: Moves a global parameter up in the order.
  • MoveDownOrder: Moves a global parameter down in the order.
  • IsUniqueGlobalParameterName: Checks if a global parameter name is unique.
  • IsValidGlobalParameter: Validates if an ElementId is a global parameter.
  • AreGlobalParametersAllowed: Checks if global parameters are permitted in the document.

Element Association Extensions

  • IsAnalyticalElement: Determines whether an element is an analytical element.
  • IsPhysicalElement: Checks if an element is a physical one.

Element Validation Extensions

  • CanDeleteElement: Indicates if an element can be deleted.

Element Worksharing Extensions

  • GetCheckoutStatus: Retrieves the ownership status of an element, with an optional parameter to return the owner's name.
  • GetWorksharingTooltipInfo: Provides worksharing information about an element for in-canvas tooltips.
  • GetModelUpdatesStatus: Gets the status of an element in the central model.

Document Extensions

  • GetProfileSymbols: Returns profile family symbols in the document.
  • RelinquishOwnership: Allows relinquishment of ownership based on specified options.

Document Managers Extensions

  • GetTemporaryGraphicsManager: Fetches a reference to the document’s temporary graphics manager.
  • GetAnalyticalToPhysicalAssociationManager: Retrieves the manager for analytical-to-physical element associations.
  • GetLightGroupManager: Creates or retrieves the light group manager for the document.

ForgeTypeId Extensions

  • IsSpec: Validates if a ForgeTypeId identifies a spec.
  • IsBuiltInGroup: Determines whether a ForgeTypeId identifies a built-in parameter group.
  • IsBuiltInParameter: Validates if a ForgeTypeId identifies a built-in parameter.
  • IsSymbol: Checks if a ForgeTypeId identifies a symbol.
  • IsUnit: Verifies if a ForgeTypeId identifies a unit.
  • IsValidDataType: Determines if a ForgeTypeId identifies a valid parameter data type.
  • IsValidUnit: Validates if a unit is valid for a measurable spec.
  • IsMeasurableSpec: Checks if a ForgeTypeId represents a measurable spec.
  • GetBuiltInParameter: Retrieves a BuiltInParameter from a ForgeTypeId.
  • GetParameterTypeId: Fetches the ForgeTypeId corresponding to a BuiltInParameter.
  • GetDiscipline: Gets the discipline for a measurable spec.
  • GetValidUnits: Retrieves all valid units for a measurable spec.
  • GetTypeCatalogStringForSpec: Fetches the type catalog string for a measurable spec.
  • GetTypeCatalogStringForUnit: Retrieves the type catalog string for a unit.
  • DownloadCompanyName: Downloads the owning company name for a parameter and records it in the document.
  • DownloadParameterOptions: Fetches settings related to a parameter from the Parameters Service.
  • DownloadParameter: Creates a shared parameter element in a document based on a downloaded parameter definition.

Color Extensions

  • ToHex: Converts a color to its hexadecimal representation.
  • ToHexInteger: Returns the hexadecimal integer representation of a color.
  • ToRgb: Provides the RGB representation of a color.
  • ToHsl: Converts a color to its HSL representation.
  • ToHsv: Converts a color to its HSV representation.
  • ToCmyk: Retrieves the CMYK representation of a color.
  • ToHsb: Converts a color to HSB.
  • ToHsi: Converts a color to HSI format.
  • ToHwb: Provides the HWB representation of a color.
  • ToNCol: Converts a color to NCol format.
  • ToCielab: Retrieves the Cielab representation of a color.
  • ToCieXyz: Converts a color to CieXyz format.
  • ToFloat: Returns the float representation of a color.
  • ToDecimal: Returns the decimal representation of a color.

Family Extensions

  • CanConvertToFaceHostBased: Indicates whether a family can be converted to a face-hosted version.
  • ConvertToFaceHostBased: Converts a family to be face-host based.

Plumbing Extensions

  • ConnectPipePlaceholdersAtElbow: Connects pipe placeholders that form an elbow connection.
  • ConnectPipePlaceholdersAtTee: Connects pipe placeholders to form a Tee connection.
  • ConnectPipePlaceholdersAtCross: Connects pipe placeholders to form a Cross connection.
  • PlaceCapOnOpenEnds: Places caps on open pipe connectors.
  • HasOpenConnector: Checks if a pipe curve has an open piping connector.
  • BreakCurve: Splits a pipe curve at a specified point.

Element Solid Cut Extensions

  • GetCuttingSolids: Retrieves solids that cut a given element.
  • GetSolidsBeingCut: Returns solids that are cut by the given element.
  • IsAllowedForSolidCut: Verifies if the element can be involved in a solid-solid cut.
  • IsElementFromAppropriateContext: Checks if the element belongs to a suitable context for solid cuts.
  • CanElementCutElement: Determines whether a cutting element can create a solid cut on a target element.
  • CutExistsBetweenElements: Checks if there is an existing solid-solid cut between two elements.
  • AddCutBetweenSolids: Adds a solid-solid cut between two elements.
  • RemoveCutBetweenSolids: Removes an existing solid cut between two elements.
  • SplitFacesOfCuttingSolid: Splits the faces of a cutting solid element.

View Extensions

  • GetTransformFromViewToView: Returns a transformation to copy elements between two views.

View Managers Extensions

  • CreateSpatialFieldManager: Creates a SpatialField manager for a given view.
  • GetSpatialFieldManager: Retrieves the SpatialField manager for a specific view.

Breaking changes

  • ToFraction: Now uses "8" precision, instead of "32".
  • ToFraction: Now suppress "0" for inches part.
  • SetAvailabilityController: Now returns PushButton instead of RibbonButton.

Readme has been updated, you can find a detailed description and code samples in it.

Full changelog: 2025.0.0...2026.0.1

Assets 16

2025.0.0

02 Apr 11:31
@github-actions github-actions
2025.0.0
66859d2

Choose a tag to compare

View all tags
2025.0.0
  • Revit 2025 support
  • New FindParameter() overloads with GUID and Definition. This method combines all API methods for getting a parameter, such as get_Parameter, LookupParameter, GetParameter. It also searches for a parameter in the element type if there is no such parameter in the element
  • GetParameter() method is obsolete. Use FindParameter() instead
  • New extensions to help you add context menu items without creating additional classes or specifying type names. Revit 2025 and higher

The ConfigureContextMenu() method registers an action used to configure a Context menu.

application.ConfigureContextMenu(menu =>
{
    menu.AddMenuItem<Command>("Menu title");
    menu.AddMenuItem<Command>("Menu title")
        .SetAvailabilityController<Controller>()
        .SetToolTip("Description");
});

You can also specify your own context menu title. By default, Revit uses the Application name

application.ConfigureContextMenu("Title", menu =>
{
    menu.AddMenuItem<Command>("Menu title");
});

The AddMenuItem() method adds a menu item to the Context Menu.

menu.AddMenuItem<Command>("Menu title");

The AddSeparator() method adds a separator to the Context Menu.

menu.AddSeparator();

The AddSubMenu() method adds a sub menu to the Context Menu.

var subMenu = new ContextMenu();
subMenu.AddMenuItem<Command>("Menu title");
subMenu.AddMenuItem<Command>("Menu title");

menu.AddSubMenu("Sub menu title", subMenu);

The SetAvailabilityController() method specifies the class type that decides the availability of menu item.

menuItem.SetAvailabilityController<Controller>()

Full changelog: 2024.0.0...2025.0.0

Loading

2024.0.0

04 Apr 08:28
@github-actions github-actions
2024.0.0
b51991d

Choose a tag to compare

View all tags
2024.0.0

Revit 2024 support

Loading

2023.1.9

17 Nov 13:23
@github-actions github-actions
2023.1.9
77c31b0

Choose a tag to compare

View all tags
2023.1.9

ElementExtensions:

  • Method chain support

ElementIdExtensions:

  • Fixed cast operations. Directly cast used by default (safe cast early)

SchemaExtensions:

  • SaveEntity now return bool if the entity save was successful

SystemExtensions:

  • AppendPath overload with params
Loading

2023.1.8

10 Oct 09:58
@github-actions github-actions
2023.1.8
7196fc8

Choose a tag to compare

View all tags
2023.1.8

UnitExtensions:

  • New FromUnit extension
  • New ToUnit extension
Loading

2023.1.7

10 Sep 16:27
@github-actions github-actions
2023.1.7
c9f8ead

Choose a tag to compare

View all tags
2023.1.7

RibbonExtensions:

  • New SetAvailabilityController() extension

ParameterExtensions:

  • New Set(bool) extension
  • New Set(color) extension

Nuget symbol server support: https://symbols.nuget.org/download/symbols

Loading

2023.1.6

09 Aug 08:25
@github-actions github-actions
2023.1.6
e2987d3

Choose a tag to compare

View all tags
2023.1.6

CollectorExtensions:

  • New GetElements(ElementId viewId) extension
  • New GetElements(ICollection elementIds) extension
  • New overloads for instances with ViewId
Loading

2023.1.5

04 Aug 14:31
@github-actions github-actions
2023.1.5
4f524ce

Choose a tag to compare

View all tags
2023.1.5

New Parameter extensions

Fixed GetParameter extensions for cases where the parameter value was not initialized

Loading