Skip to main content

Configure translations

SecureAuth supports internationalization (i18n) to localize the identity experience across multiple languages. This includes login UI text, consent screens, email templates, and SMS messages.

You can manage translations directly from the admin portal without requiring theme customization or code changes.

💡 Why this matters
Localization helps you deliver personalized, compliant, and user-friendly experiences across global identity journeys. Use workspace-level translation management for granular control over multi-brand and multi-region deployments.

Watch this video to understand how internationalization works:

Translations vs. internationalization​

Internationalization (i18n) The process of designing software to support multiple languages and regions.

Translations The actual localized text strings for specific languages.

Use the i18n system in SecureAuth IAM to:

  • Configure translations for any supported language
  • Set fallback languages when translations are missing
  • Preview changes in real-time
  • Manage translations at the workspace level for multi-brand deployments

Supported areas for translation​

You can configure translations for:

  • Login and registration page labels
  • Error messages and form placeholders
  • Consent and privacy text
  • Email templates (subject and body)
  • SMS messages (OTP, alerts)

Step-by-step guide​

Step 1: Access the Tenant Settings​

Do one of the following:

  • From any workspace, scroll down in the left navigation and click View all workspaces

  • Click the gear icon in the top right and select Appearance

    SecureAuth Admin Console workspace selection

Step 2: Enable translations​

  1. Select the Settings tab.

  2. Select the check boxes for Enable translations and Enable language selector.

    Enable translations

Step 3. Add a new language for translation​

  1. Select Languages tab.

  2. Click Create Language.

  3. From the list, select a language option (for example, es, fr, de, ar). Select a language for translation

  4. Click Create.
    The language management interface displays. Language management interface

SecureAuth supports a wide range of languages and locales. Enable multiple languages for the same workspace and configure fallback behavior for untranslated strings.

Step 4: Edit translation text​

  1. From the list, click the language (translation key) you want to edit. List of languages
  2. Enter your custom translated text. Language management interface
  3. Save your changes.

Translation workflow​

For efficient translation management:

  1. Start with your primary language Complete all translations in your main language first.
  2. Use consistent terminology Maintain a glossary of key terms across all languages.
  3. Test with real content Preview translations with actual user data when possible.
  4. Review in context Check how translations appear in different UI states (loading, error, success).
  5. Validate with native speakers Have team members fluent in each target language review translations.

Best practices​

  • Keep translations consistent with your brand tone and legal requirements.
  • Use variable placeholders (e.g., {{username}}, {{code}}) carefully.
  • Update translations when you introduce new consent fields or UI customizations.