Customize login and splash screens in Unified Service Desk
Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016
You can customize the branding of Unified Service Desk login and splash screens to change the name and appearance of the application name on the login screen and change the application name, appearance, foreground and background colors of the splash screen by modifying XAML styles.
Note
This feature was introduced in Unified Service Desk 2.2 release. Also, with Unified Service Desk 2.2, login and splash screens support the high-contrast mode setting in Windows.
In This Topic
What you can customize?
How you can customize?
Customization examples
What you can customize?
The following XAML is used to customize the branding of login and splash screens in Unified Service Desk:
<ResourceDictionary xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
xmlns:resx1="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Properties">
<Style x:Key="FormAppNameStyle" TargetType="TextBlock">
<Setter Property="Foreground" Value="Black"></Setter>
<Setter Property="FontFamily" Value="Segoe UI"></Setter>
<Setter Property="FontSize" Value="30"></Setter>
<Setter Property="Background" Value="White"></Setter>
<Setter Property="Text" Value="Unified Service Desk"></Setter>
</Style>
<Style x:Key="SplashAppNameStyle" TargetType="Label">
<Setter Property="Foreground" Value="White"></Setter>
<Setter Property="FontFamily" Value="/UnifiedServiceDesk;component/Fonts/#Segoe UI"></Setter>
<Setter Property="FontSize" Value="40"></Setter>
<Setter Property="Content" Value="Unified Service Desk"></Setter>
</Style>
<Style x:Key="SplashScreenDefaultFontStyle" TargetType="TextBlock">
<Setter Property="FontSize" Value="12px"/>
<Setter Property="Foreground" Value="White"/>
<Setter Property="TextWrapping" Value="Wrap"/>
<Setter Property="TextTrimming" Value="WordEllipsis"/>
<Setter Property="FontFamily" Value="Segoe UI"/>
</Style>
<Style x:Key="SplashGridBgColor" TargetType="Grid">
<Setter Property="Background" Value="Blue"></Setter>
</Style>
</ResourceDictionary>
The XAML file contains the following four styles for which you must specify appropriate values in the Setter Property:
XAML Style |
Description |
---|---|
FormAppNameStyle |
Change the content and appearance of application name on login screen. |
SplashAppNameStyle |
Change the content and appearance of application name on splash screen. |
SplashScreenDefaultFontStyle |
Change the appearance of status text on splash screen. |
SplashGridBgColor |
Change the background color of splash screen. |
How you can customize?
You can customize the branding of login and splash screens in Unified Service Desk by following the steps below.
Open Notepad, and copy the entire contents of the XAML file mentioned in the previous section.
Under the appropriate XAML style block, change the Value of appropriate Setter Property.
For example, to modify the font size of the app name displayed on the splash screen, change the value of the FontSize setter property under the SplashAppNameStyle style.
You can modify values for multiple setter properties under a XAML style or across multiple XAML styles.
If you haven't changed setter property values under a XAML style, remove the style block from the Notepad file.
For example, if you just changed setter properties for SplashAppNameStyle, remove the other styles to prevent the settings under those styles being applied to your client application. See examples later in this topic.
Save the file as "CustomerSplashStyles.xaml".
Copy the "CustomerSplashStyles.xaml" to the Unified Service Desk client directory, typically "C:\Program Files\Microsoft Dynamics CRM USD\USD". You must have system administrator privileges to copy the file to the client directory.
If you are running the Unified Service Desk client, restart it for the changes to take effect.
Customization examples
Here are some customization examples.
Change the application name of login screen
CustomerSplashStyles.xaml |
Customization Outcome |
---|---|
|
Change the application name and appearance of splash screen
CustomerSplashStyles.xaml |
Customization Outcome |
---|---|
|
See Also
Customize themes in Unified Service Desk
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. Copyright