In various places the Servoy brand is exposed to users of both Smart and Web Clients. To customize the user experience, these exposures to the Servoy brand can be overridden to expose a custom brand.
There are several locations that require updating to fully customize the user experience:
- Branding Settings
- Default webpages
- Library signing
The Servoy Admin page exposes several Branding settings on it's main page. By enabling Branding support by setting the
servoy.branding setting to true and providing custom values for the other properties, the first part of the user experience can be customized.
What it controls
Controls whether or not all the other Branding settings are applied or not
Controls the splash screen shown by WebStart when launching a Smart Client
Allows animated GIF's
Controls the image used inside WebStart UI's
Controls the Vendor name displayed in WebStart
Controls the label text for Desktop Shortcuts
Controls the text in the TitleBar and/or browser tab
Smart & Web & NG Client
Controls the Icon used in the TitleBar and/or browser tab
Controls the image shown in the Smart Client at startup, before a Solution is loaded
Sets the background color of the Smart Client window when no form is being shown, for example after showing a custom login form and before the main form of the solution is shown
Hides the main Smart client window during solution load in Smart Client.
While the main window is hidden the loading image (
Some branding settings only have effect on the Servoy Application Server, not for Debug Clients in Servoy Developer
More information about overriding Web Client templates can be found on the Customizing the Web Client page and for the NGClient on the Customizing the NG Client page.
Servoy contains a number of webpages for starting client and exception handling. All these pages can be customized.
Note that by default all the pages are virtual, meaning they are not stored on disk, but are available when accessed through a browser via the server's url at
To customize the pages, the virtual version needs to be stored on disk in the provided customization location in the table below, using the exact same name. After storing the file to disk in the appropriate location, that version will be used. Note that accessing the file through the server's url will now return the stored version. By deleting the stored version, the default virtual version will start to be used again.
Starting Smart Clients
This page is also the default webpage shown when accessing just the serverUrl
Starting Web Clients
The list can be empty if solution browsing is disabled
Default Web Client login page
Solutions can override page by implementing a Login solution for authentication
Page shown when a Web Client session is expired
Page shown when trying to start a new Web Client and there are no licenses left
Page shown when a new Web Client is being started in an unsupported browser
The only unsupported browser currently is Internet Explorer <6 IF anchoring is enabled. See 'servoy.webclient.enableAnchors' for more info
When using the Smart Client for the first time, the user will be presented with a Security dialog of Java WebStart, asking the user to trust the vendor of the libraries of which the application consists.
All libraries that come with Servoy are signed by Servoy, thus the user will be presented with the Security dialog and asked to trust the vendor Servoy.
It is possible to resign all the libraries using a Signed Certificate issued with a different vendor name. For more information on resigning the libraries, see SignTester tool on ServoyForge.