IT Deployment Guide

How to deploy, license and centrally manage Tray Selector across your organisation using the MSI installer, Microsoft Intune or Group Policy.

Applies to Tray Selector 3.12 and later. Questions? Email support@trayselector.com — we're happy to help with your rollout.

1. System requirements

  • Windows 10 or Windows 11 (Windows Server with Remote Desktop Services is also supported).
  • Microsoft Word for Windows (desktop app), 32-bit or 64-bit, including Microsoft 365 Apps.
  • .NET Framework 4.6 or later — already included in Windows 10 and 11.
  • Local administrator rights (or a deployment tool running as SYSTEM) to install.

2. The installer package

The download is a zip file containing:

  • TraySelector.msi — the Windows Installer package. Use this for managed deployment.
  • setup.exe — a bootstrapper for interactive installs (checks for .NET, then runs the MSI).
  • README.txt

Both files are code-signed by Thinking-Machine Limited.

Product nameTraySelector
ManufacturerThinking Machine Ltd
Default install folderC:\Program Files (x86)\Thinking Machine Ltd\TraySelector\
Upgrade code (same for all versions){75ED7B51-BD62-494E-B1AB-DBFD59139E43}
Product code (version 3.14){66AAE3E8-18ED-420C-9AEB-A9C9334FE45E} — changes with each version

The same package works with both 32-bit and 64-bit Word.

3. Silent install, upgrade and uninstall

Install for all users

msiexec /i "TraySelector.msi" ALLUSERS=1 /qn /norestart /l*v "%TEMP%\TraySelector-install.log"
We recommend including ALLUSERS=1 to force a per-machine install. Without it, the package installs per-machine when run with administrator rights (as Intune, SCCM and Group Policy do), but only for the current user if run without them. With ALLUSERS=1, an install without administrator rights fails instead of silently installing for one user.

Close Microsoft Word before installing or upgrading; the add-in loads the next time Word starts.

Upgrade

Deploy the newer MSI with the same command. It automatically removes the previous version first, and users' profiles and settings are kept (they are stored per user in the registry, not in the install folder).

Uninstall

msiexec /x {66AAE3E8-18ED-420C-9AEB-A9C9334FE45E} /qn /norestart

The product code above is for version 3.14. To uninstall whichever version is installed, you can use PowerShell:

$app = Get-ItemProperty 'HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*',
                       'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' -ErrorAction SilentlyContinue |
       Where-Object { $_.DisplayName -eq 'TraySelector' }
foreach ($a in $app) { Start-Process msiexec.exe -ArgumentList "/x $($a.PSChildName) /qn /norestart" -Wait }

4. Deploying the licence key

Instead of each user entering the licence key, you can deploy it centrally. Tray Selector looks for the key in this order:

Option A (recommended): a licence file

Create a plain-text file named license.txt containing only your licence key, in the install folder:

C:\Program Files (x86)\Thinking Machine Ltd\TraySelector\license.txt

This works for every user of the computer and for both 32-bit and 64-bit Word. Copy the file after the MSI has installed (and again after upgrades if your tool replaces the folder).

Option B: the registry

Set this value under HKEY_LOCAL_MACHINE:

KeyValue nameTypeData
HKLM\SOFTWARE\TraySelector\KeyLicenseDotNetREG_SZYour licence key

Because Word reads the registry view that matches its own bitness, write the value to both views so it works with 32-bit and 64-bit Word:

reg add "HKLM\SOFTWARE\TraySelector\Key" /v LicenseDotNet /t REG_SZ /d "YOUR-LICENCE-KEY" /f /reg:64
reg add "HKLM\SOFTWARE\TraySelector\Key" /v LicenseDotNet /t REG_SZ /d "YOUR-LICENCE-KEY" /f /reg:32

On first use, Tray Selector copies the key to the user's own registry (HKCU\Software\TraySelector\Key).

5. Microsoft Intune

Deploy Tray Selector as a Windows app (Win32), which supports install commands with properties and detection rules.

1. Package the MSI

Put TraySelector.msi (and optionally a script that writes license.txt) in a folder, then wrap it with Microsoft's Win32 Content Prep Tool:

IntuneWinAppUtil.exe -c C:\Packages\TraySelector -s TraySelector.msi -o C:\Packages\Output

2. Create the app

In the Intune admin centre go to Apps → Windows → Add → Windows app (Win32) and upload the .intunewin file.

Install commandmsiexec /i "TraySelector.msi" ALLUSERS=1 /qn /norestart
Uninstall commandmsiexec /x {66AAE3E8-18ED-420C-9AEB-A9C9334FE45E} /qn /norestart
Install behaviourSystem
Device restart behaviourNo specific action
RequirementsWindows 10 or later; 32-bit and 64-bit
Detection ruleRule type MSI — Intune fills in the product code automatically from the uploaded MSI

When you upload a new version, add it as a new app and use Intune's Supersedence setting to replace the old one.

3. Deploy the licence key

Either include a small install script in the package that installs the MSI and then writes license.txt, or deploy a separate PowerShell script (Devices → Scripts) running as SYSTEM:

$folder = "${env:ProgramFiles(x86)}\Thinking Machine Ltd\TraySelector"
if (Test-Path $folder) { Set-Content -Path "$folder\license.txt" -Value "YOUR-LICENCE-KEY" -NoNewline }

4. Deploy user settings and profiles

The lockdown settings in section 7 and printer profiles in section 8 are per user (HKEY_CURRENT_USER). Deploy them with a PowerShell script set to Run this script using the logged on credentials: Yes, for example:

New-Item -Path 'HKCU:\Software\TraySelector' -Force | Out-Null
Set-ItemProperty -Path 'HKCU:\Software\TraySelector' -Name 'SettingsVisible' -Value 0 -Type DWord

6. Group Policy

Install the software

  1. Copy TraySelector.msi to a network share that computers can read (e.g. \\server\software\TraySelector\).
  2. In a GPO linked to your computers, go to Computer Configuration → Policies → Software Settings → Software installation, choose New → Package, select the MSI by its UNC path and choose Assigned.
  3. The software installs at the next restart. To upgrade, add the new MSI to the same GPO and mark it as an upgrade of the existing package.

Alternatively, run the silent install command from a computer startup script or your software deployment tool.

Deploy the licence and settings

Use Group Policy Preferences:

  • Licence key: Computer Configuration → Preferences → Windows Settings → Files to copy license.txt into the install folder, or Registry to set the LicenseDotNet value (create the item twice, once for each registry view, or use the file instead).
  • Lockdown settings and profiles: User Configuration → Preferences → Windows Settings → Registry, using the values in section 7.

7. Lockdown and admin settings

All values are under HKEY_CURRENT_USER\Software\TraySelector unless shown otherwise. Where a setting can also be set under HKEY_LOCAL_MACHINE\SOFTWARE\TraySelector, the user value takes priority and the machine value applies when no user value is set. Restart Word after changing settings.

Value nameTypeDataEffectWhere
SettingsVisibleDWORD0Hides the Tray Selector Settings button on the Word ribbon, so users can print with profiles but not change them.User
HideOptionsREG_SZany text, e.g. 1Hides the Options button in the settings window.User
Profiles\N\LockedDWORD1Makes profile N read-only (changes to it are not saved). Profiles are numbered from 0 (the first button).User
NumProfilesDWORD1–20Number of profile slots available (default and maximum 20).User
CheckForUpdatesREG_SZfalseDisables the Check for Updates button, if you manage versions centrally.User or machine
AllowDeactivateREG_SZfalseStops users deactivating the licence on their computer.User or machine
DisableMsgBoxDWORD1Suppresses Tray Selector's informational message boxes.User
SuppressMailMergeREG_SZsee noteControls the mail merge confirmation prompt. Contact support for the values for your scenario.User or machine
Printer name#OKTrayNamesREG_SZtray names separated by |Only these trays can be chosen for that printer.User or machine
Printer name#BadTrayNamesREG_SZtray names separated by |These trays cannot be chosen for that printer.User or machine
loggingREG_SZ1Turns on diagnostic logging (useful when working with our support team).User

Example: restrict the printer \\printsrv\Legal-MFP so users can only pick the letterhead and plain-paper trays:

reg add "HKCU\Software\TraySelector" /v "\\printsrv\Legal-MFP#OKTrayNames" /t REG_SZ /d "Tray 2|Tray 3" /f

Tray names must match exactly what the printer driver reports (as shown in Tray Selector's settings window).

8. Deploying standard printer profiles

Profile buttons are stored per user under HKEY_CURRENT_USER\Software\TraySelector\Profiles. To give everyone the same buttons:

  1. On a reference computer, set up the profiles in Tray Selector exactly as you want them.
  2. Export them:
    reg export "HKCU\Software\TraySelector\Profiles" TraySelector-Profiles.reg
  3. Import the file for each user (in the user's context) with Intune, a logon script or Group Policy Preferences:
    reg import TraySelector-Profiles.reg
  4. Optionally lock the profiles (Profiles\N\Locked = 1) and hide the Settings button (SettingsVisible = 0).

Printer names must match on every computer, and users need access to the same printers. For profiles that should follow each user's default printer, tick Mask to default printer in the profile before exporting.

9. Remote Desktop Services and Citrix

  • Install once per session host with ALLUSERS=1 (in install mode, e.g. change user /install, or via your image build).
  • Deploy the licence with license.txt in the install folder so every user on the host is licensed.
  • Profiles and settings live in each user's registry (HKCU), so they roam with your user profile solution (roaming profiles, FSLogix, Citrix Profile Management).
  • If printers are redirected with session-specific names, use Mask to default printer on profiles so they follow the user's current default printer.

10. Troubleshooting

  • The Tray Selector tab doesn't appear in Word: check the app was installed with ALLUSERS=1; then in Word open File → Options → Add-ins, check Disabled Items and re-enable Tray Selector, and check it is ticked under COM Add-ins. See also our guide on the blog.
  • Printing always goes to the same tray: set the paper source in the printer driver's defaults to Auto Select or Printer default so Tray Selector can control it (see the FAQ).
  • Install fails: review the log created with /l*v, and check .NET Framework 4.6 or later is present.
  • Licence not detected: check license.txt contains only the key, or that LicenseDotNet is set in both registry views.

Planning a rollout?

We help IT teams and support providers deploy Tray Selector every week. Email support@trayselector.com with your environment (Intune, Group Policy, RDS/Citrix) and we'll help you get it right first time.