Catenda HUB Revit plugin
Julien Benoit avatar
Written by Julien Benoit
Updated this week

Note: By clicking on the link below you can find the install file for the plugin.

Version 1.0.8

The following topics will be described in this article:

Getting started

After installing the plugin, open a Revit model and click on the Catenda button in the Add-Ins.

Login with your email address and Catenda Hub password.


Click on “Allow access” to allow the Revit add-in to access your Catenda Hub account. This will open the main view of the Catenda Hub add-in.


You can remove the access to your Catenda Hub account at any time by going to your Catenda Hub application page and click on “Revoke access” near “Revit plugin for Catenda Hub”.

Issue List

In this page, you will find the main menu to navigate in your Catenda Hub project, issue boards and issues.


  1. Select your Catenda Hub project

  2. Select an issue board in this project

  3. Create a new issue in the currently selected issue board

  4. Sort currently displayed issues

  5. Open the Catenda Hub add-in menu

  6. Search and filter the displayed issues

  7. The list of currently filtered issues in the issue board

Project and issue board selection

Selecting a Catenda Hub project will display the list of issue board in this project, allowing you to selected one to display the corresponding issues. It will also save the Catenda Hub project and issue board in your Revit model and open them automatically the next time you open this model.


Bimsymc Add-in Menu

  1. Go to the Upload page

  2. Open the Settings page

  3. Open your Catenda Hub account page in your default browser

  4. Log out from your Catenda Hub account

Issue selection

In the issue list, you will find all the main information about an issue:

  1. The title of the issue

  2. Its status (Open, Closed, …), its type (Info, Error, …) and its labels

  3. The member requesting the issue

  4. The member the issue is assigned to

  5. The due date of the issue

  6. When the issue was last updated. You can hover over the date to display the full date and time of update.

  7. The number of comments in the issue

  8. The image of the first comment in the issue

  9. Catenda Hub issue number

You can click on any issue to go to the issue detail page.

Sort issues

You can sort the displayed issues to bring he most relevant to you first.

  1. Bring the most recently created issue first

  2. Bring the oldest issue first

  3. Bring the most recently updated issue first. Updating an issue can involve changing any of this properties, title, comments, …

  4. Bring the least recently updated issue first

  5. Bring the most recent due date first

  6. Bring the oldest due date first

Filter issues

Using the filter bar, you can combine any type of filter to display only the most relevant issues.

Current filters are displayed as small chips in the filter bar. Here, only issues with the “Open” status are displayed. Click in the filter bar to display all availlable filters (1).


On the left (2) is the name of the filter, every filter belong to a type displayed on the right (3).

Available filters types includes:

  • Requested By: Get all issues requested by a given user

  • Assigned To: Get all issues assigned to a given user

  • Due Date: Get all overdue issues or issue due in less than a month, two week, a week or a day

  • Status: Get all issues of a given status (Open, Closed, …)

  • Type: Get all issues of a given type (Error, Warning, Info, …)

  • Label: Get all issues with a given label

  • My issues: Get all issues assigned or requested by yourself

You can search for these filters by typing text in the filter bar (1). You can also use this to create a text filter to search for a specific text in the issue title or description (2).


Issue Details

In this view, you can review and edit a specific issue.


  1. Go back to the Issue List

  2. Refresh the content of this issue

  3. Navigate between issues

  4. Set the issue status (Open, Closed, …)

  5. Set the issue type (Error, Warning, Info, …)

  6. Set the due date of the issue

  7. Set the member assigned to the issue. You can assign an issue to an individual user or a team.

  8. Set the member requesting this issue. You can set an individual user or a team.

  9. Edit the issue labels

  10. The list of comments in the issue

Issue properties

You can edit any property of the issue: Status, type, assignee, requester, due date, labels. Every menu will display a list of available properties. However, you cannot create a new status, type or label directly in the plugin, you will have to use the web interface of Catenda Hub to do that.

You can click on the title to edit it:


You can click on the pen icon to edit the description:


You can also type text in the label bar to filter down the list of filters:



All comments are displayed below the issue. A comment can contains text, a picture, a snapshot from your Revit current view or a viewpoint.

  1. The author of the comment

  2. When the comment was created. You can hover over the date to display the full date and time of update.

  3. The image associated with the comment

  4. The text of the comment


If the comment contains a viewpoint, you can zoom to this viewpoint. Zoom in will create a new 3D view in your Revit model focused on the same viewpoint.


For the viewpoint to be relevant, you must have opened the same model than the one where the comment was created. The plugin assumed that Shared Coordinates where used while exporting the model to IFC.

If the viewpoint has been created from a perspective view, the new 3D view will have its projection mode set to “Perspective”. Otherwise, the projection mode will be “Orthographic”.

The add-in will create only one perspective view and one orthographic view. After having created them, it will reuse them for any subsequent use of the zoom function. You can change that in the settings menu. You can also use the settings menu to change the name of these view.

Related elements

If the issue contains related elements, the add-in will select them in Revit when you zoom to a viewpoint.


For this function to work, you Revit model must have been exported to IFC with the “Store the IFC GUID in an element parameter after export”. This add the IFCGuid parameter on every object, allowing the plugin to select the related elements.

Add comment

You can add comments to an issue by writing in the text box and clicking on Submit.

You can also add a picture from your computer by clicking on the “Plus” button. You can annotate this picture by clicking on the preview image after selecting it.


Add 3D snapshot

You can also add your current Revit view as a viewpoint and a snapshot attached to your comment. Just like any picture, you can annotate the snapshot by clicking on the preview image.

If the IFCGUID parameter is present, selected elements in Revit will be added to your issue as related elements.

Upload to Catenda Hub

You can upload your current Revit model directly to Catenda Hub as an IFC file.

After opening the upload page:

  1. Select the Catenda Hub model where you will be creating a new revision

  2. Type in a comment associated with the upload

  3. Select an IFC configuration. A new configuration can be created in the IFC export menu in Revit. You can also select the <Catenda setup> for an easy to use configuration well suited to Catenda Hub.

  4. Click on Upload

selectedConfig.Name = "<Catenda Setup>"; selectedConfig.IFCVersion = IFCVersion.IFC2x3CV2; selectedConfig.SpaceBoundaries = 1; selectedConfig.ActivePhaseId = ElementId.InvalidElementId; selectedConfig.ExportBaseQuantities = true; selectedConfig.SplitWallsAndColumns = false; selectedConfig.VisibleElementsOfCurrentView = false; selectedConfig.Use2DRoomBoundaryForVolume = false; selectedConfig.UseFamilyAndTypeNameForReference = true; selectedConfig.ExportInternalRevitPropertySets = true; selectedConfig.ExportIFCCommonPropertySets = true; selectedConfig.Export2DElements = false; selectedConfig.ExportPartsAsBuildingElements = true; selectedConfig.ExportBoundingBox = false; selectedConfig.ExportSolidModelRep = false; selectedConfig.ExportSchedulesAsPsets = false; selectedConfig.ExportUserDefinedPsets = false; selectedConfig.ExportUserDefinedPsetsFileName = ""; selectedConfig.ExportLinkedFiles = false; selectedConfig.IncludeSiteElevation = true; selectedConfig.UseActiveViewGeometry = false; selectedConfig.ExportSpecificSchedules = false; selectedConfig.TessellationLevelOfDetail = 0; selectedConfig.StoreIFCGUID = true; selectedConfig.ExportRoomsInView = true;


The settings page allows you to change how the plugin will create 3D view when using the Zoom function.

  1. Keep the 3D view orthographic. This option will force the Revit 3D view to be orthographic even if the corresponding viewpoint has been created with a perspective view.

  2. Create a new view for every issue. Instead of reusing the same 3D view each time you use the Zoom function, this option will create a new 3D view for every issue each time you use the zoom function.

  3. 3D view name suffix. This text will be added to the name of the 3D view created when using the Zoom function.

Did this answer your question?