> ## Documentation Index > Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Features export const app_0 = "AutodeskRevit" export const versions_0 = "2020, 2021, 2022, 2023 and 2024" export const connector_0 = "Revit"
Notice: This user guide is based on the legacy {connector_0} connector.
We recommend using our new connectors instead, as they are easier to use and actively maintained. This legacy documentation may not be up to date.
Legacy Speckle supports {app_0} versions: {versions_0} In this page, we'll share how Revit Connector converts your Revit model into Speckle format and how it handles updating in Revit. ## Converting Revit data to Speckle When sending from Revit, Speckle takes care of converting the data to a Speckle-friendly format. If you're curious about how this data is being structured, please have a look at our **[Objects kit class definitions](https://github.com/specklesystems/speckle-sharp/tree/master/Objects/Objects/BuiltElements)**. For instance, a Revit room will look like this: Room data structure * At a high level we have all the main properties that define the room, such as: * name * area * number * geometry * category * etc. For every category of element, you'll have some main properties quickly accessible at a high level. Keys and their values may change depending on the element. All the other Revit parameters, both **type and instance**, are nested inside the **parameters** property. See an example below: Room parameters * **ROOM\_AREA:** Internal Revit Name (API) of the Area parameter for Rooms. * **name:** represents the name of the parameter. In the above image, it is "Area". * **value:** represents the value of the parameter. In this case, it's "2233.64" * **isShared:** True if parameter is a shared parameter. * **isReadOnly:** True if parameter is a readonly parameter. * **speckleType:** Speckle representation of the element. In this case, it is a "Objects.BuiltElements.Revit.Parameter" object. * **and more…** All the parameters are stored using their **internal Revit names**. You can see the full list of `BuiltInParameter` values **[here](https://www.revitapidocs.com/2022/fb011c91-be7e-f737-28c7-3f1e1917a0e0.htm)**. If you need to access their display name, just refer to the `name` property of each parameter, but please keep in mind these are not unique and can vary between languages. ## Updating elements in Revit The connector takes care of updating received elements automatically where possible (instead of deleting and re-creating them). This is preferred, as Dimensions, ElementIds, and other annotations are preserved. **Elements are updated under these two circumstances:** * If the element was created in another project/software and had been received previously: for example, BuiltElements that were created in Rhino or Grasshopper. * If the element was created in the same project you're working on: for example, if you send some walls to Speckle, edit them, and receive them again from the same model Here are some technical details if you're curious about what's happening behind the scenes: * BuiltElements have a property called `applicationId`, this is different from the `id/hash` property on them, and represents the id of such element in the host application in which it was first created. If the element was created in Revit it's the `UniqueId`, if coming from Grasshopper/Rhino an analogous field * When a model is received in Revit the `applicationIds` of all BuiltElements created are cached in the receiver * When receiving a second time from the same model, if the received elements have the same `applicationId` of something that was previously received (and it still exists in the document), the connector will attempt to modify them instead of creating new ones. If the update fails (or is not permitted by the API), it'll delete them and create new ones * If no cached element is found, but there is an element in the document with a matching `applicationId` that is used for the update (this is the case of someone restoring changes previously sent, in the same project) * If an element being received doesn't have an `applicationId` no update mechanism will happen (this could be the case of BuiltElements created in Python if no `applicationIds` are generated manually) ### Levels Levels in Revit are updated following the logic described above with just one minor exception: if you receive a level in a model that already has a level at the same elevation, the existing one will be used and its name will be updated if needed. For example, you receive `Level 03` which is at 9000mm, in a file that has `3rd Floor` at 9000mm => `3rd Floor` will be renamed and used (we use a tolerance of 5mm for matching levels by elevation). NOTE: Levels are *not matched by name* as this could end up with undesired results. ## Family Editor The Revit Connector also works in the Family Editor for asub set of element types. ## Linked models The Revit Connector supports linked models, here's how it works. ### Sending linked models The Revit Connector supports sending linked models. To enable this feature, go to Advanced Settings and select the option for [Sending Linked Models](/legacy/user/revit/advanced-settings#_2-send-linked-models) . Once this is done, you can use the selection filters as usual and any relevant items from the linked models will also be sent. For instance: *Everything* will send all the models, *Category* filters will work in conjunction with any linked model elements, and *Selection* too. #### Sending by view When sending by **view**, the linked model support works as follows: * **Revit 2024:** only elements of the linked models visible in the selcted view(s) will be sent * **Revit 2023 and before:** The whole linked model is sent unless it is not visible in the selected view(s). This is a limitation of the Revit API. Multiple instances of the same linked model are currently not supported on sending. ### Receiving linked models Revit Connector also supports receiving linked elements. To enable this option, Go to Advanced Settings and check [Receiving Linked Models](/legacy/user/revit/advanced-settings#_3-receive-linked-models). On receiving we do not attempt to modify linked model files in any way, but when the *Receive Linked Models* setting is turned on, the linked model elements will be received in the current document as any other element. ## Design options The Connector also supports Revit design options and you can publish different options of your model to Speckle. Design options ### How does it work? If the selection filter is set to **Everything**, the Connector sends the **Main model** and any objects that are part of a **primary** design option by default. To publish other options with the Main model, simply select any other option from the Design Options drop-down. ### Using 3D views You can also set up a view in Revit and associate desired options with it in the **Visibility/Graphic Overrides**, see **Design Options** tab. Visibility/Graphic Overrides Then choose **View** selection filter in the Connector and pick a view. Only objects visible in this view will be sent to Speckle, which allows you to organise your Revit model for quick and easy publishing. Send 3D view ## Using the Scheduler (Alpha) Sometimes, you might want to send data to Speckle automatically, based on a few triggers. For this, we have added a "**Scheduler**" functionality to the Revit Connector. Before using the Scheduler, you need to **send your model** through the connector interface. (*Note: Make sure to select the selection filter you intend to use when the scheduler is triggered, for instance, to send all the model or a particular view.*) Scheduler interface 1. **Enabled**: When turned on, Scheduler will send the model to selected **Project** with the selected **Trigger**) 2. Select **Project**: Select the project card you used in the connector interface. Currently, only one scheduler can be set per file. We are planning to enable setting up multiple schedulers from the Main Connector interface. 3. Select **Trigger**: Currently the following triggers are available: * **On File Save** * **On Sync To Central** * **On File Export** 4. Click "**Save**". That's it! Every time you save your file, for instance, your data will be sent to Speckle.