Jump to content


Deploying Custom Registry Settings for Office 2010

2 replies to this topic

#1 mashti


    Microsoft TE

  • Technical Expert
  • PipPipPipPipPipPip
  • 1,552 posts
  • 38915 thanks
  • LocationActive Directory Inside

Posted 31 May 2011 - 06:10 PM

If you are planning to customise your Office 2010 deployment significantly, then at some point, you will more than likely need to make changes to the registry. Perhaps you wrote a custom add-in that you need to define (In “HKLM\Software\Microsoft\Office\Word\Addins”), or maybe you want to tweak the status bar in more detail than OCT or Group Policy allows (In “HKCU\Software\Microsoft\Office\14.0\Word\StatusBar”). Whatever the case, you are probably going to find yourself wondering what is the best way to effect these changes.

In this post, I would like to describe a robust and efficient way to control Office 2010 registry settings, using a combination of the Microsoft Office Customization Tool (OCT)
and a little known feature in Office 2010 (and Office 2007 for that matter) best described as HKLM –> HKCU Propagation.

Let’s try to understand a little more about why changing these settings can be difficult.

Firstly, registry settings for Office are applied by default, at various stages during the deployment process. These stages include:

    * During the Office installation
    * After the Office installation
    * When the user who installed Office first launches an Office application
    * When a different user first launches an Office application
    * When settings are changed by the user at some other point in time

Naturally, this array adds complexity and often leads to confusion. How do you know when in the process to set your custom values? Set them too early and they may get overwritten… Set them too late and you might have your applications start before the settings are applied.

Secondly, registry settings for Office span across the HKEY_CURRENT_USER (HKCU) space, the HKEY_LOCAL_MACHINE (HKLM) space, and the HKEY_CLASSES_ROOT (HKCR) space. Global settings tend to live in HKLM, however the majority of settings that you will look to customise will be located in HKCU. This makes it difficult to apply settings to each user’s HKCU, as well as users who you don’t even know about yet.

Applying settings for the user who installs Office is relatively straight forward, you could use a VBScript, PowerShell, or even a simple batch file to add or remove registry values. You could also use the OCT to add new values, however for reasons we’ll get to later, you will struggle to change or remove keys or values using this method.

It gets tricky when you want your changes to effect not only the HKCU of the user who installs Office, but all users, including those who have already logged into a given computer, and those who haven’t. You might consider mounting the Default User’s NTUSER.dat hive and making the changes there, however not only is that generally unsupported, it won’t help for users who have already logged onto the computer, as they already have a profile. Also, some settings will be overwritten when the user first launches an Office application.

OK… enough doom and gloom, let’s talk about a solution.

Step 1 – Propagating the Settings

The functionality we are relying on here is executed each time an Office application is launched and is controlled entirely through the registry. Let’s take a look at how to use it. In this example, we are going to apply some settings related to the word status bar, to every Office user on the computer.

First, open Regedit. Navigate to one of the following keys, as appropriate.

Windows 32bit, Office 2010 32bit

   HKLM\SOFTWARE\Microsoft\Office\14.0\User Settings
Windows 64bit, Office 2010 32bit

   HKLM\SOFTWARE\Wow6432Node\Microsoft\Office\14.0\User Settings
Windows 32bit, Office 2007 32bit

   HKLM\SOFTWARE\Microsoft\Office\12.0\User Settings
Windows 64bit, Office 2007 32bit

   HKLM\SOFTWARE\Wow6432Node\Microsoft\Office\12.0\User Settings
Create a new key here, call it whatever you like, I’ve named mine “FTPropagation”. Next add a DWORD value called “Count”, set it to “0x00000001

Posted Image

Under your key (the one I called “FTPropagation”) add a key called either “Create” or “Delete”, depending on if you want to add or remove information from HKCU, in this case, I’m going to use “Create”.

Under the create key, you will need to add keys that correspond to the locations in HKCU you wish to change. In my case, I want to add values to HKCU\Software\Microsoft\Office\14.0\Word\StatusBar, so the key I need to make is as follows:

HKLM\Software\Microsoft\Office\14.0\User Settings\FTSettings\Create\Software\Microsoft\Office\14.0\Word\StatusBar
This is explained below.

Posted Image

Group Name = Whatever you like

Action = Either Create or Delete

HKCU Key Location = Whatever key you would like to change inside the HKCU of every user.

Next we can add any values that we wish to propagate, I’ll add a bunch that define how I want the status bar to look for my users.

Posted Image

That’s it! done… open Microsoft Word and take a look inside HKCU, you’ll notice that all the settings you defined have magically appeared. Now log on as a different user and Open Word, you’ll notice the settings propagate each time a user launches an Office application.

If you want to change some of these settings at a later date, simply make the changes in HKLM, then change the value of the “Count” key to something different (perhaps 0x00000002), your changes will propagate next time someone opens an Office application.

Whilst you have Regedit open, you can export your configuration, by right-clicking the key I describe above as “Group Name” in HKLM and selecting export. This will come in handy later, as you will see.

Posted Image

Step 2 – Deploying the Settings

So now that we have an reliable method for adding, changing or removing registry settings for every user, let’s take a quick look at how to deploy these settings along with your Office Installation. For the purpose of brevity, I’m going to assume you are familiar with the Microsoft Office Customization Tool (OCT). If you aren’t, you will find plenty of information on TechNet.
OK, so let’s open OCT by navigating to our Office 2010 installation directory and running “Setup.exe /admin”. Don’t forget you need to use Volume Licensing media to gain access to OCT.

We can apply our changes using the “Add registry entries” section. You’ll notice there is a convenient Import utility, which will allow us to… you guessed it… import settings from the .reg file we created earlier.

Posted Image

Posted Image

And we’re done! make sure you have your “Count” value in there, as well as the keys and values you wish to propagate out to all your users. Just save your.msp file and you are ready to go.

But hang on a second, why don’t we just use the “Add registry entries” and “Remove registry entries” sections in OCT and forget all this HKLM –> HKCU propagation rubbish? well…. I’ll tell you why… it’s because of a fairly major limitation in the OCT’s behaviour. Essentially the OCT will add entries just fine, however it will not modify or remove HKCU entries that Office creates at first log on. This is presumably due to the fact that the Office HKCU default entries are only created when a user launches an Office application for the first time. It appears that the OCT custom registry entries are applied before Office creates its default entries, so the custom entries are simply overwritten.

If you want to see the functionality in action, take a look at the video below.

HKCU Propagation

The original post was made by Yoni Kirsh from Fastrack Technology, original source -


Edited by harry817, 01 June 2011 - 06:22 AM.
contribution added

Whenever death may surprise us, let it be welcome if our battle cry has reached even one receptive ear and another hand reaches out to take up our arms.
I know you are here to kill me. Shoot, coward, you are only going to kill a man.

Che Guevara

Thanked by 2 Members:
msftgeek , Dreamfall

#2 msftgeek


    Junior Member

  • Members
  • PipPip
  • 5 posts
  • 1 thanks

Posted 07 August 2012 - 01:07 AM

The Office Customization tool is of such great help in an enterprise environment.
If you used correctly you can stop almost all viruses spreading through outlook and MS word.

#3 xiaoxiaomei


    Junior Member

  • Members
  • PipPip
  • 1 posts
  • 0 thanks

Posted 01 March 2018 - 03:16 AM


0 user(s) are reading this topic

0 members, 0 guests, 0 anonymous users




Test Providers

Site Info

Go to top