Initializing help system before first use

# Customizing the User Interface

Administrators can upload images, add text, and apply colour scheme updates to certain elements of the Web Client user interface to adjust corporate branding.

Administrators can customize specific elements of the Xpress Insight user interface by editing the `application.properties` file that provides string values that will used for some messages, and that identifies which uploaded image should be used for each element. This customization will then be visible to all users.

## Configurable properties

The following user interface elements can be customized. All elements that contain images, and the browser icon element, must be absolute paths to the image location on the server that Xpress Insight is running on. Images used must be `png`, `jpg`, or `jpeg`.

Property | Type | Description
--- | --- | ---
Browser icon | Image | The icon displayed on the browser tab.
Browser title | String | The text displayed in the browser tab.
Footer message | String | The text displayed as a footer on all pages.
Login screen background image | Image | The background image displayed on the login screen.
Login screen footer message color | String | The color of the login screen footer.
Login screen logo image | Image | The logo displayed on the login screen.
Login screen message | String | The message displayed above the login username and password fields.
Home screen background image | Image | The background image displayed on the Home screen.
Home screen footer message color | String | The color of the Home screen footer.
Masthead background color | String | The background color of the masthead shown after login.
Masthead default help URL | String | The URL users will be sent to if they click Help in the upper right.
Masthead default title | String | The text displayed at the top of the masthead after login.
Masthead foreground color | String | The foreground color of the masthead shown after login.
Masthead logo image | Image | The logo displayed in the upper-left of the masthead.

## Configurable file example

The application.properties file contains the following branding configuration section that must be edited to contain the strings, color codes, or paths to images to be shown on the Xpress Insight web client user interface.

    #------------------------------------------------------------------------------
    # Branding Configuration
    #------------------------------------------------------------------------------

    # Used to set a custom icon that the browser will display. Must be in .ico or .png format. Use the path to the image.
    # insight.server.branding.browser-icon=

    # Used to set a custom title for the browser to display
    # insight.server.branding.browser-title=

    # Used to set custom footer text to be displayed on all pages
    # insight.server.branding.footer-message=

    # Used to set a custom background image for the login page. Use the path to the image.
    # insight.server.branding.login-background-image=

    # Used to set a custom color for the footer text displayed on the login page
    # insight.server.branding.login-footer-message-color=

    # Used to set a custom logo image on the login page. Use the path to the image.
    # insight.server.branding.login-logo-image=

    # Used to set custom message text to be displayed on the login page
    # insight.server.branding.login-message=

    # Used to set a custom background image for the home page. Use the path to the image.
    # insight.server.branding.home-background-image=

    # Used to set a custom color for the footer text displayed on the home page
    # insight.server.branding.home-footer-message-color=

    # Used to set a custom background color for the masthead
    # insight.server.branding.masthead-background-color=

    # Used to set a custom URL for the documentation
    # insight.server.branding.masthead-default-help-url=

    # Used to set a custom default title for the masthead
    # insight.server.branding.masthead-default-title=

    # Used to set a custom foreground color for the masthead
    # insight.server.branding.masthead-foreground-color=

    # Used to set a custom logo image for the masthead. Use the path to the image.
    # insight.server.branding.masthead-logo-image=

Parent Topic Insight 5 Administrator Guide

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.