Modify change password pages

Edit online

You can customize the IBM® Verify change password pages for your business.

To update the change password pages, download the compressed theme file. Edit the pages as needed and then upload the updated themes file back to your tenant. For more information, see Updating a theme.

Text changes can be made to the pages by using HTML markup. The HTML files also contain macros. Macros are characters between the @ symbol where the data is rendered at run time. Do not change the macros in the files.

The IBM Verify change password pages for English are located in the templates\authentication\login\cloud_directory\password\change_password\default\ directory within the compressed theme file. The translated pages that are available are located in the templates\authentication\login\cloud_directory\password\change_password\<locale>\ directories within the compressed theme file.

You can customize the following password pages:

Modify first login change password page

This page is displayed to a new user on initial login that requests that the user change their password. Update the first_login_change_password.html file to modify the page.

The following labels are available on the first login change password page. To update the text on these labels, see Customizing labels.
  • $CHANGE_PASSWORD_TITLE$
  • $CHANGE_PASSWORD_NEW$
  • $CHANGE_PASSWORD_CONFIRM$
  • $CHANGE_PASSWORD_LABEL$

The macros for this page are shown in the following table.

Table 1. Macro definitions
Macro Value that replaces the macro
@ACTION@ The action that is taken.
@ERROR_MESSAGE@ An error message that is specific to the action in the page.
@OLDPASSWORD@ The old password.
@PAGE_FOOTER@ The HTML that contains the footer of the page. This code can be modified by customizing the footer.html common template.
@PAGE_HEADER@ The HTML that contains the header of the page. This code can be modified by customizing the header.html common template.
@PASSWORDWARNING@ A password warning.
@POLICYMESSAGE Information about the policy.
@THEME_ID@ The ID of the registered template theme.
@USERNAME The username of the user.
Modify on-demand change password page

This page is displayed when a user requests a password change. Update the on_demand_change_password.html file to modify the page.

The following labels are available on the on-demand change password page. To update the text on these labels, see Customizing labels.
  • $CHANGE_PWD_TITLE$
  • $CHANGE_PWD_LABEL$
  • $CHANGE_PWD_DESCRIPTION$
  • $CHANGE_PWD_CURRENT$
  • $CHANGE_PWD_NEW$
  • $CHANGE_PWD_CONFIRM$
  • $CHANGE_PWD_CANCEL$

The macros for this page are shown in the following table.

Table 2. Macro definitions
Macro Value that replaces the macro
@ACTION@ The action that is taken.
@ERROR_MESSAGE@ An error message that is specific to the action in the page.
@ERROR_CONFIRM_PASSWORD_EMPTY@ Error for empty confirm password.
@ERROR_CURRENT_PASSWORD_EMPTY@ Error for empty current password.
@ERROR_NEW_PASSWORD_EMPTY@ Error for empty new password.
@OLDPASSWORD@ The old password.
@PAGE_FOOTER@ The HTML that contains the footer of the page. This code can be modified by customizing the footer.html common template.
@PAGE_HEADER@ The HTML that contains the header of the page. This code can be modified by customizing the header.html common template.
@POLICYMESSAGE Information about the policy.
@THEME_ID@ The ID of the registered template theme.
@USERNAME The username of the user.

To change the page header, footer, and style on the change password pages, see Create common branding.