Customize Sage CRM login screen

Feature ID: CRMS-1301

With this new feature, you can:

  • Display and position your custom logo on the login screen.

  • Change the background of the entire login screen, its top area (where the Sage logo is located), its middle area (where the login form is located), or its bottom area.

To perform these customizations, you can use the preconfigured .css and .js files supplied with Sage CRM.

  1. On a Sage CRM server, locate the following files:

    File name

    Location

    custom-logon.css

    Use this file to change the background color of the login screen and to position your custom logo.

    <Sage CRM installation folder>\WWWRoot\Img\logon\css

    By default, Sage CRM is installed to %ProgramFiles(x86)%\Sage\CRM\CRM.

    ChangeLogonLogo.js

    Use this file to specify the name of the file that stores the custom logo you want to display on the login screen.

    You can store your custom logo in a .gif, .jpeg, .png, or .svg file. The file name can include the following characters only: 
    A-Z, a-z, 0-9, underscore (_), full stop (.), and hyphen (-).

    <Sage CRM installation folder>\WWWRoot\Img\logon\js

  2. Edit the custom-logon.css and ChangeLogonLogo.js files to set the desired background color and specify the name of your custom logo file, if necessary. For details, see the annotations in the files.

  3. Save your changes.

  4. If you want to display a custom logo, copy your custom logo file to
    <Sage CRM installation folder>\WWWRoot\Img\logon\gif.

  5. Copy the edited custom-logon.css and ChangeLogonLogo.js files to the following locations. Skip copying ChangeLogonLogo.js if you don't need to display a custom logo.

    File name

    Copy to

    custom-logon.css

    <Sage CRM installation folder>\WWWRoot\Themes\custom

    ChangeLogonLogo.js

    <Sage CRM installation folder>\WWWRoot\js\custom

Now you can open the Sage CRM login screen to view your customizations.

When you upgrade Sage CRM, the Sage CRM Setup does not replace or modify the custom-logon.css and ChangeLogonLogo.js files in the locations you copied them to.