Customizing text elements
17.4.10. Customizing text elements in the Loginapp (JSP)
  • Initial setup
  • .
    For all instances:
    Create the files (and so on) to directory ./instances/common/loginapp-texts/
  • .
    For one specific instance:
    Create the files (and so on) to directory ./instances/<instance-name>/loginapp-texts/
  • Language templates
  • 1.
    In the IAM installation folder open app/loginapp/WEB-INF/classes/strings_*.properties (* choose the correct language code).
  • 2.
    Find the desired existing text via search (e.g. "Login failed").
  • 3.
    Copy the line into the newly created string-property file from "Initial setup" and adapt the copied wording as required.
  • Do not make changes in the original strings_*.properties file.

  • The changes are applied automatically after 30 seconds.


To change the login page input field label from "Username" to "Contract-No.", store the file with the contents

loginpage.username = Contract-No.

to directory ./instances/common/loginapp-texts/.

Adding a new language

The following steps are required to add a new language to the JSP-Loginapp:

  • Add string property file: to common instance or specific instance (e.g. for the loginapp to ./instances/common/loginapp-texts/ or ./instances/<instance-name>/loginapp-texts/ (create the directory if it doesn't exist))
  • Add as valid language: Using the ConfigEditor, add the new language as a valid language (Loginapp >> Language Settings)
  • Adapt Webpages: If the user can change the display language on the pages of the loginapp: Adapt the links (usually part of the sub-page header.jsp). See 17.4.11. Customizing UI (look and feel) of the JSP-Loginapp on how to proceed with this and how to activate the changes.

To test, you can call any page using the HTTP GET parameter lang=xx (where "xx" is the two-letter ISO language code).

Further information and links