Customize Login Messages

This section is about how to customize the messages that one gets after being unsuccesfful at logging in to the website.

Default Setup

Here are the different error types that are used and the default messages that show up for each type of error:

Error Type	What does it do	Error Message
RMS_ALREADY_LOGGED_IN	user is logged in	"You are already logged in. Log out first to log in again."
RMS_INVALID_PASSWORD	invalid password	"Invalid email/username or password."
RMS_NOT_FOUND	user name not found	"Invalid user name or password."
RMS_DISABLED	user cannot login - account disabled	"Your account was disabled by the administrator."
RMS_TIMED_OUT	user was logged out due to inactivity	"Your session expired due to inactivity."
RMS_EXPIRED	user account expired	"Your account expired."
RMS_KICKED_OUT	somebody else logged into same account	"Somebody else is using your account!"

Steps to Customize Messages

Step 1: Find the page

Look for the /login or the /403 page in the CMS module.

save image

Step 2: Edit the page

Click Edit or double click the page

Step 3: Switch editor

Switch to Source view if you're not already seeing it

save image

Step 4: Verify code

You should see some code that is like the folllowing:

<sys:login> </sys:login>

Step 5: Replace code

Based on whether you have a single language or a multi-language site, replace the above with the one of the following code options in the Source editor:

For single language sites:

<sys:login>
<sys:on-login-failure>
<div class="checkoutError">
<div>
<sys:on-login-failure error="RMS_ALREADY_LOGGED_IN">
You are already logged in. Log out first to log in again.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_INVALID_PASSWORD">
Invalid email/username or password.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_NOT_FOUND">
Invalid user name or password.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_DISABLED">
Oops! There seems to be an issue with this login. Please contact us to straighten it out.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_TIMED_OUT">
Your session expired due to inactivity.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_EXPIRED">
Your account expired.
</sys:on-login-failure>
<sys:on-login-failure error="RMS_KICKED_OUT">
Somebody else is using your account!
</sys:on-login-failure>
</div>
</div>
</sys:on-login-failure>

<div class="form-horizontal">
   <div class="control-group">
   <label class="control-label">Username</label>
   <div class="controls">
       <input name="text" type="text" login-type="name"/>
   </div>
   </div>
   <div class="control-group">
   <label class="control-label">Password</label>
   <div class="controls">
       <input name="password" type="password" login-type="password"/>
   </div>
   </div>
   <div class="control-group">
   <div class="controls">
       <label class="checkbox" for="remember">
       <input id='rmsRemember' login-type='remember' type='checkbox'/>
       Remember me on this computer</label>
   </div>
   </div>
   <div class="control-group">
   <div class="controls">
       <input name="submit" type="submit" value="Login" class="btn btn-primary"/>
   </div>
   </div>
   <div class="control-group">
   <div class="controls">
       <a href="/password-recovery/">Password recovery link</a>
   </div>
   </div>
</div></sys:login>

For multi-lingual websites:

The code is wrapped with <sys:tr> tags so you can find the phrases in the Translations module:

<sys:login>
<sys:on-login-failure>
<div class="checkoutError">
<div>
<sys:on-login-failure error="RMS_ALREADY_LOGGED_IN">
   <sys:tr> You are already logged in. Log out first to log in again.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_INVALID_PASSWORD">
   <sys:tr> Invalid email/username or password.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_NOT_FOUND">
<sys:tr> Invalid user name or password.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_DISABLED">
   <sys:tr> Oops! There seems to be an issue with this login. Please contact us to straighten it out.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_TIMED_OUT">
<sys:tr> Your session expired due to inactivity.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_EXPIRED">
<sys:tr> Your account expired.</sys:tr>
</sys:on-login-failure>
<sys:on-login-failure error="RMS_KICKED_OUT">
<sys:tr> Somebody else is using your account!</sys:tr>
</sys:on-login-failure>
</div>
</div>
</sys:on-login-failure>

</sys:login>

Step 6: Save

Hit the Save button when you're done replacing the code.

Step 7: Rewrite error message

Go to the message(s) that you'd like to change in the editor and rename the message as you'd like.

Step 8: Save

Hit the Save button.

Please send us suggestions regarding this documentation page
If you would like to recommend improvements to this page, please leave a suggestion for the documentation team.