Customize the RD Web Client theme on RDS 2022

Replace the logo, background, favicon and page text of your RD Web Client 2022 Quick Theme.

After you install the theme, you can add your own logo, background and text. You do this by replacing files in the theme's theme-assets folder.

Find the theme assets#

Open the Web Client content folder from IIS Manager (right-click webclient and select Explore), then open theme-assets:

content\theme-assets

This folder holds the logo, background, favicon and the customStrings.js file.

Replace the images#

Save your image with the file name in the table, then copy it into theme-assets and replace the existing file.

File	What it is	Recommended size
`logo.png`	Your logo	Up to 250 px wide and 80 px high
`bg.jpg`	Page background (JPEG)	1920 × 906 px. Any size works.
`Favicon.png`	Browser tab icon (PNG)	75 × 75 px

The sizes are recommendations. You can use other sizes: place the images, check the page in a browser and adjust.

Tip

Keep the background file as small as you can, so the page loads fast.

Change the page text#

Open customStrings.js in theme-assets with a text editor, such as Notepad.

Change the values of these variables:

Variable	Text it sets
`titleText`	The page title shown in the browser tab
`footerText`	The footer text, such as your copyright line
`loginText`	The label of the sign-in button
`afterLoginLogo`	Set to `hide` or `false` to hide your logo after sign-in. Leave it as `show` to keep it.
`privacyLabel`	The privacy policy link text on the sign-in page. Leave it empty (`""`) to hide the link.
`privacyLink`	The URL the privacy policy link opens

Save the file.

CustomStrings.js open in Notepad from the Web Client theme-assets folder, showing titleText, footerText, loginText, afterLoginLogo, privacyLabel and privacyLink

Troubleshooting#

Windows is on a different drive. This guide uses C:\ because it is the most common system drive. If Windows is installed on another drive, use that drive letter instead.
Your changes don't show in the browser. This is usually the browser cache. Do a hard refresh or clear the browser cache, then reload the page.
Something went wrong. Restore the backup of the default files you made before installing. Always back up the default interface files before you install a theme, customize it or apply an update.