File Registration

Knowledge BaseGetting Started
File Registration

In this article


Guardian protections, features, and analytics will only work if project files are registered. Even if none of the Guardian features have been enabled, having projects registered will allow some of the basic functionality to be utilized, such as:

  • Purging of unused properties for incoming elements.
  • Capturing data analytics on different command activities.
  • Notifying Admins about the use of protected commands.

Project models must be registered before Guardian will be activated for a given project. There are two ways in which projects can be registered:

  1. Automatic Registration under Settings > Company Settings.
  2. Manual Registration by selecting the Register Project icon or Settings > Projects.

This allows Company Administrators to determine what type of projects will be registered. For instance, a non-workshared project model may not want to be registered as it’s only for specific study or only register project models hosted on BIM360.

Automatic Registration

Project models can be registered automatically based on some predetermined rules. The rules can be set up under Settings > Company Settings > File Registration.

File Registration steps

(A) Registration: Rules can be created for different file types to be registered automatically when created or opened.  

(B) Click the Edit rules button next to each model type to further specify the conditions in which the models get registered.

Rules dialog

Within the Rules dialog, many different conditions can be added in AND and OR configurations similar to Revit View Filter rules. Use the Add Condition button to add conditions from the available condition types.

Each rule can be used to register files automatically or to apply the selected configurations when registering files manually. To disable automatic registration, select the Manual registration only checkbox.

Condition type options

(C) When creating a model from another existing registered model, the registration behavior can be specified to either use the existing Mapping Configuration, Project Configuration, Administrators, and Workset Set or to apply fresh registration rules based on current needs.

Manual Registration

Project models can be manually registered by selecting the Register Project button in the Guardian Add-Ins tab.

Blue arrow pointing to Register Project button

When manually registering files, a prompt will appear for Administrators to specify the desired Mapping Configuration, Project Configuration, Workset Set, and Administrators. If any set rules apply to the active project, the configurations will be filled automatically based on the rule's selection.

Project Registration dialog

Have questions?

Reach out to learn more, ask any questions, or meet the team! We'd love to learn more about your challenges and explore the more proactive solution.

Get in Touch