Update User Settings Across an Organization

Change one or more Revit.ini settings for users across your organization.

You will create a custom Revit.ini and place the custom file to the UserDataCache folder on each user's computer.

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 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.
      The format of the install section is as follows:

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

      As an example this is what the Install section would look like for the example shown in 1.b.:

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

   4. The final custom Revit.ini file will look like this:

      [AppFrame]
      Theme=0
      [Documentation]
      HelpBrowser=1
      OnlineHelpLocale=enu
      [Install]
      Update=Appframe|Theme;Documentation|HelpBrowser;Documentation|OnlineHelpLocale

      Note: The complete Revit.ini is not swhown in the example, only the sections that would be altered for the example.
   5. 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\RVT 2025\UserDataCache

2. Ask users to restart the Revit software.

   The next time a user starts the 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 software.