> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation. # 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 Menu icon **> 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](/docs/customization/configure-multilingual-login.md) to restrict which languages appear in the language selector and provide translated overrides. - [Brand your login pages](/docs/customization/brand-your-login-pages.md) to apply visual branding alongside your custom text.