Text to Element - User Guide & Reference

The Text to Element utility (Parameters category) Transfers text note contents to Revit element parameters based on physical boundary overlap in the active view. Ideal for mapping annotation tags or CAD text block values directly to Revit families..

1. Overview & Key Capabilities

The Text to Element tool is designed to improve workflow efficiency by automating standard tasks. Key capabilities include:

• Transfers text note contents to Revit element parameters based on physical boundary overlap in the active view.
• Ideal for mapping annotation tags or CAD text block values directly to Revit families.

2. Detailed Step-by-Step Usage

Follow these instructions to use the tool in your active Revit session:

1. Open Text to Element dialog.
2. Select source Text Notes and choose target elements category (e.g., Mechanical Equipment).
3. Select target parameter (e.g., Mark, Comments, or shared parameter).
4. Click Find Intersections to view overlaps (Text Note bounding boxes intersecting elements).
5. Review matches in the preview grid.
6. Click Write Values to transfer text data to Revit parameters.

3. Technical Specifications & Under the Hood

Revit API Integration

• Key API Components: Parameter retrieval and value assignment (parameter.Set()), mapping spatial bounds intersections (BoundingBoxIsWithin filters).
• Transaction Handling: All modifications are packaged into a single Revit API transaction. If any error occurs, the changes are rolled back automatically to preserve model integrity.

[!TIP] Best Practice Tip: Use this to map room parameter values to the equipment contained inside. Double check that shared parameters are loaded.