Customize login page text and messages

IDaaS displays default text on login, registration, password-reset, and error pages. IDaaS already provides translations for all supported locales, so the default text works out of the box in every language. However, you can override any string with your own wording. For example, you can override the string to use organization-specific terminology ("Employee ID" instead of "User ID"), add your helpdesk contact information to error messages, or meet regulatory requirements for specific wording.

IDaaS supports overriding 79 user-facing strings, and each override can be set independently per locale so your custom wording carries through to every language your organization uses.

When to customize messages

Use custom messages when you need to address one or more of the following scenarios.

Scenario	Example
Terminology alignment	Replace User ID with Employee ID or Badge Number to match your internal vocabulary.
Branded error guidance	Replace generic error messages with actionable instructions like Contact the IT helpdesk at ext. 4567.
Regulatory wording	Modify authentication prompts to include required disclosures or consent language.
Multilingual custom wording	Apply your organization-specific overrides in each locale. IDaaS already provides translations for all default strings, so this is only needed when you want your custom wording to appear in multiple languages.

---

Edit individual messages

Override a single string for a specific language.

1. Click > Customization > Theme. The Theme page appears.
2. Select the Custom Messages tab.
3. Select the target language from the locale drop-down list.
4. Find the string you want to customize:
   • Use the search field to filter by label, default text, or custom text.
   • Optional: Set the filter to Customized Only to view strings you have already overridden.
5. Enter your custom text in the Custom Override column for the target string.
6. Click Save.

warning

Some strings contain placeholder tokens such as {} that insert dynamic values (for example, company name or retry counts). If your custom text removes a placeholder, a warning appears. You can omit the placeholder if you prefer to hard-code the value instead.

Bulk edit with import and export

Use the import and export workflow for large-scale changes, such as translating all strings for a new locale or applying terminology changes across many messages.

Export current strings

1. On the Custom Messages tab, select the locale you want to export.
2. Click Export.
3. Save the downloaded JSON file. It contains all string keys with their default and custom values for that locale.

Edit the exported file

Open the JSON file in a text editor or hand it off to a translation team. Edit the custom values as needed. Keep the JSON structure and key names unchanged.

Import updated strings

1. On the Custom Messages tab, click Import.
2. Select the modified JSON file.
3. Review the diff that shows current values compared to imported values.
4. Click Apply Changes.
5. Click Save.

Filter and audit customizations

The Custom Messages tab provides tools to track what you have customized.

• Filter mode: Switch between All Strings and Customized Only to focus on overridden values.
• Customization count badge: Each locale in the language drop-down shows a count of how many strings are currently overridden.
• Search: Search across label, default text, and custom text simultaneously to find specific strings.

Reset messages

You can reset custom messages in two ways.

Reset all messages for a locale

1. On the Custom Messages tab, select the target locale.
2. Click Reset All for that locale.
3. Confirm the reset.

This clears all custom overrides for that language and reverts every string to the platform default.

Reset an individual string

1. Find the customized string using search or the Customized Only filter.
2. Click the reset icon next to the string.
3. Click Save.

---

Optional tooltip strings

Some custom message strings are optional tooltips that do not appear on the login page by default. These tooltips only display when you provide a custom value, giving you a way to add contextual help without changing the existing layout.

String	Key	Effect
User ID Tooltip	common.loginAuth.enterUserIdTooltip	Displays a tooltip on the user ID entry field to guide users (for example, Enter your Employee ID).
Remember Me Tooltip	common.authFlow.rememberMeTooltip	Displays a tooltip on the Remember Me option to explain its behavior.
Alternative Authentication Tooltip	common.authFlow.alternativeAuthenticationTooltip	Displays a tooltip on the alternative authentication link to clarify what it does.

To add a tooltip, enter a custom value for the string on the Custom Messages tab. To remove a tooltip, reset the string to its default (empty) value.

---

Restrictions

note

• Each custom string has a maximum length of 500 characters.
• Some default strings contain placeholder tokens ({}) that insert dynamic values such as the company name. If you remove a placeholder, a warning appears. You can safely omit the placeholder if you prefer to hard-code the value in your custom text.
• HTML tags in custom text are escaped and displayed as plain text. You cannot use HTML to format custom messages.

Best practices

• Keep overrides short and clear. Users scan login pages quickly. Concise text performs better than lengthy instructions.
• Test overrides using the live preview on the Custom Theme tab before saving.
• When customizing error messages, include actionable guidance (for example, who to contact and how) rather than only restating the error.

Next steps

• Configure multilingual login pages to restrict which languages appear in the language selector and provide translated overrides.
• Brand your login pages to apply visual branding alongside your custom text.