Updating User Settings Across an Organization

If you want to change one or more Revit.ini settings for users across your organization, you can use the following procedure to simplify the task.

1. Create a custom version of the Revit.ini file, as follows:
   1. Create a copy of Revit.ini, preserving the original version so you can return to it if needed.
   2. Edit the new copy of Revit.ini, changing the values of the desired settings as needed.

      For a list of settings and valid values, see The Revit.ini File.

      For example, suppose you want to change the Theme value in the AppFrame section, and values of the HelpBrowser and OnlineHelpLocale settings in the Documentation section.

      [AppFrame]
      Theme=0
      [Documentation]
      HelpBrowser=1
      OnlineHelpLocale=enu

   3. In the Install section of Revit.ini, add the Update setting to indicate the sections and settings that are to be changed for each user who receives the updated Revit.ini file.
      Use this format:

      Update=section|setting;section|setting;section|setting...

      For example:

      [Install]
      Update=Appframe|Theme;Documentation|HelpBrowser;Documentation|OnlineHelpLocale

   4. Use a script or group policy object (GPO) to push the updated Revit.ini file to the UserDataCache folder on each user's computer.

      The UserDataCache version of Revit.ini resides in the following location:

      %ALLUSERSPROFILE%\Autodesk\<product name and release>\UserDataCache

2. Ask users to restart the Revit software.

   The next time a user starts the Revit software, Revit compares UserDataCache\Revit.ini with the user profile version of the Revit.ini file. When it determines that the Update setting in the UserDataCache version is different than the Update setting in the user profile version (or it does not exist there), Revit copies the settings specified by the Update setting in UserDataCache\Revit.ini from that file to the user profile version of the Revit.ini file, overwriting previous values for those settings. Other values in the user profile version of the Revit.ini file are not changed.

Example

Before the user restarts Revit, the user profile version of the Revit.ini file shows the following values:

[AppFrame]
Theme=1
[Documentation]
HelpBrowser=0
OnlineHelpLocale=fra

After the user restarts Revit (which triggers the setting updates), the user profile version of the Revit.ini file shows the following values:

[AppFrame]
Theme=0
[Documentation]
HelpBrowser=1
OnlineHelpLocale=enu

The updated settings are now implemented for the user. Those settings will be used each time the user starts the Revit software.