Web Only User Activation and Account Recovery URLs
🎯 URL Localization Overview
User activation and account recovery screens can be localized by adding a language parameter to the URL, enabling direct language specification for specific processes.
📋 URL Parameter Implementation
🔧 Language Parameter
- Parameter Name:
lang
\ - Format: Locale identifier (e.g.,
es-ES
,fr-FR
,de-DE
) - Usage: Appended to existing URLs as query parameter
- Override Behavior: Overrides previously selected language preference
🌐 URL Examples
📧 Web Only User Activation URLs
Before Internationalization:
https://auth.relid.com:8006/relid/authserver/register?token=9d14686f6a3e-4506-a260-c4fc77da7071
After Internationalization (Spanish Language):
https://auth.relid.com:8006/relid/authserver/register?token=9d14686f6a3e-4506-a260-c4fc77da7071&lang=es-ES
🔄 Account Recovery URLs
The same lang
parameter pattern applies to account recovery URLs:
Standard Recovery URL:
https://auth.relid.com:8006/relid/authserver/recovery?token=recovery_token_value
Localized Recovery URL (French):
https://auth.relid.com:8006/relid/authserver/recovery?token=recovery_token_value&lang=fr-FR
📊 Parameter Behaviour
🎯 Language Override
- Immediate Effect: URL language parameter takes precedence over stored preference\
- Session Impact: Language selection affects entire user session
- Persistence: New language preference saved for future sessions
- Scope: Applies to all screens in the activation or recovery flow
⚙️ Integration Benefits
- Direct Links: Organizations can provide language-specific links\
- Email Integration: Localized links can be included in notification emails
- Support Efficiency: Support teams can provide language-appropriate URLs
- User Experience: Users immediately see interface in expected language
🔧 Implementation Considerations
- URL Construction: Properly encode language parameters in URLs\
- Link Generation: System-generated links can include language parameters
- Email Templates: Notification emails can use localized URLs
- Documentation: Provide URL examples for different supported languages
Updated 15 days ago