Skip to main content

Translation and Language Management in Hosted pages

Overview and Background​

You encounter Translations and Languages in different aspects, which can be the Email and SMS sent out to the users, it can be the Login and Registration Pages (Hosted Pages) but also when it comes to consents or fields.

Learn more about our Hosted Pages Management

cidaas has customers connect spread all over the world. Users from diverse geographical locations around the globe, each part with unique language preferences. Users express their desire to customize their hosted pages in their supported local language and personalize their user experience. Understanding the importance of accommodating these variations, we have developed a feature that empowers customers to personalize their hosted pages according to their preferred language.

This feature ensures that the user experience remains consistent and accessible to individuals regardless of their linguistic background.

customized-hosted-page-overview

Motivation​

The cidaas custom hosted page has ability to:

  • add or manage supported locales
  • add or manage custom translations to override existing bundled translations that come with default hosted pages.
  • add new custom translations other than the bundled translations.
  • verify the syntax of the custom translations file JSON uploaded.
  • verify the integration of custom translations with default hosted pages.

Integrate Translation and Language Hosted pages to the app​

Terminology​

Before you dive into the usage of custom hosted page translations, let's get to know the terminology.

TranslationExplanation
BundledBundled translations are sets of translations that come pre-bundled with cidaas default hosted pages. Currently, the supported bundles are for two languages: English (en) and German (de). In the case of bundles, customers can override partially the texts they want to change.
CustomCustom translations are when the customer wants supported translations apart from pre-bundled languages. For example, in Italian or French. In this case, the customers are expected to provide translations for all the keys.

Note: Currently we support bundles for English (en) and German (de).

Integration​

  1. Log in to your admin dashboard.

  2. Navigate to Hosted-page > Translation tab > Create translation.

    create-hosted-pages

  3. Select your preferred language and start editing the JSON.

    edit-hosted-pages-trans

    Watch Out!​

    Placeholder should not be edited!

  4. Click on Save, and the Preview button will be activated.

  5. Click on the Preview, map your app, select the response type, copy the link, and open it in the browser.

    hosted-pages-trans-mapping

  6. Your translated hosted pages are ready to be used.

Placeholder nomenclature​

In this section, you will find all the placeholder names of the hosted pages, and you can refer to these and change the placeholders for the hosted pages.

For example, as displayed below, we have changed the placeholder name of "GUEST_LOGIN" to French, and in the preview, we can see the login hosted page placeholder GUEST_LOGIN has changed.

hosted-pages-preview-custom


Translation and Language Hosted pages keys (Login)​


Label KeyPage Reference
LOGIN.WELCOME_HEADERlogin
LOGIN.WELCOME_LABELlogin
LOGIN.CLASSICAL_LOGIN.ALLOW_LOGIN_WITH.EMAILlogin
LOGIN.CLASSICAL_LOGIN.ALLOW_LOGIN_WITH.MOBILElogin
LOGIN.CLASSICAL_LOGIN.ALLOW_LOGIN_WITH.USER_NAMElogin
LOGIN.CLASSICAL_LOGIN.BUTTON.TEXTlogin
GUEST_LOGINlogin
HR_LINE_LABELlogin
FORM.VALIDATION.EMAILlogin
REQUIRED_FIELD_DYNAMIClogin
WELCOME_BACK_TITLElogin
NO_AUTHENTICATION_METHODS_FOUNDlogin
ERROR_OCCURREDlogin
BACKlogin
ENTER_VALID_EMAILlogin
ENTER_VALID_MOBILElogin
NO_USER_FOUNDlogin
PASSWORD_CHANGEDlogin
MFA_REQUIRED.VERIFY_PASSWORDlogin
LOGIN.FORGOT_PASSWORDlogin
LOGIN.AUTHENTICATION.HOW_DO_YOU_WANT_TO_AUTHENTICATElogin
LOGIN.AUTHENTICATION.EMAIL.ICON_TEXTlogin
LOGIN.AUTHENTICATION.PASSWORD.ICON_TEXTlogin
LOGIN.AUTHENTICATION.IVR.ICON_TEXTlogin
LOGIN.AUTHENTICATION.PATTERN.ICON_TEXTlogin
LOGIN.AUTHENTICATION.SMS.ICON_TEXTlogin
LOGIN.AUTHENTICATION.TOUCHID.ICON_TEXTlogin
LOGIN.AUTHENTICATION.TOTP.ICON_TEXTlogin
LOGIN.AUTHENTICATION.BACKUPCODE.ICON_TEXTlogin
LOGIN.AUTHENTICATION.PUSH.ICON_TEXTlogin
LOGIN.AUTHENTICATION.FACE.ICON_TEXTlogin
LOGIN.AUTHENTICATION.FIDO2.ICON_TEXTlogin
LOGIN.AUTHENTICATION.EMAIL.ICON_TOOL_TIPlogin
LOGIN.AUTHENTICATION.PASSWORD.ICON_TOOL_TIPlogin
LOGIN.AUTHENTICATION.IVR.ICON_TOOL_TIPlogin
LOGIN.AUTHENTICATION.PATTERN.ICON_TOOL_TIPlogin
LOGIN.SELECT_PROVIDERS.BLOCKED.TITLElogin
LOGIN.SELECT_PROVIDERS.BLOCKED.MSGlogin
IP_BLOCKEDlogin
REQUIRED_FIELDlogin
MFA_REQUIRED.VERIFY_EMAILlogin
LOGIN.AUTHENTICATION.EMAIL.BUTTON.TEXTlogin
ERROR_CODES.VERIFICATION_SRV.AUTHENTICATE.3063login
ERROR_CODES.VERIFICATION_SRV.AUTHENTICATE.3059login
LOGIN.AUTHENTICATION.EMAIL.INPUT.LABELlogin
LOGIN.AUTHENTICATION.EMAIL.INPUT.HINTlogin
LOGIN.AUTHENTICATION.EMAIL.INPUT.PLACEHOLDERlogin
LOGIN.AUTHENTICATION.IVR.INPUT.LABELlogin
LOGIN.AUTHENTICATION.IVR.INPUT.HINTlogin
MFA_REQUIRED.VERIFY_IVRlogin

Translation and Language in the Hosted pages UI reference​

Here are the placeholders marked for you to check where exactly your editing.


Login.
hosted-page-login-trans-image-refencehosted-page-trans-image-reference-guest-loginhosted-pages-trans-img-reference-mfa-configured
hosted-pages-trans-img-refrence-ip-blockedhosted=-pages-trans-image-refrence-mfa-listhosted-pages-image-reference-tool-tip
hosted-pages-image-reference-email-verificationhosted-page-trans-image-reference-auth-input-lablehosted-page-trans-image-reference-auth-inupt-placeholder
hosted-page-trans-image-reference-error-codehosted-page-trans-image-reference-wrong-codehosted-page-trans-image-reference-webfinger
hosted-page-trans-image-reference-user-not-foundhosted-page-trans-image-reference-provider-listhosted-page-trans-image-reference-provider-list-error
hosted-page-trans-image-reference-no-provider-configuredhosted-page-trans-image-reference-email-validationhosted-page-trans-image-reference-mobile-validation
hosted-page-trans-image-reference-email-requiredhosted-page-trans-image-reference-mobile-requiredhosted-page-trans-image-reference-user-name-required
hosted-page-trans-image-reference-password-changed

Translation and Language Hosted pages keys (MFA)​


Label KeyPage reference
MFA_REQUIRED.MFA_HEADERmfa_required
MFA_REQUIRED.CONFIRM_IDENTITYmfa_required
MFA_REQUIRED.TOUCHIDmfa_required
MFA_REQUIRED.TOUCHID_DESCmfa_required
MFA_REQUIRED.EMAILmfa_required
MFA_REQUIRED.EMAIL_DESCmfa_required
MFA_REQUIRED.IVRmfa_required
MFA_REQUIRED.IVR_DESCmfa_required
MFA_REQUIRED.SMSmfa_required
MFA_REQUIRED.SMS_DESCmfa_required
MFA_REQUIRED.NO_MFA_CONFIGUREDmfa_required
MFA_REQUIRED.NEED_TO_CONFIGURE_MFAmfa_required
MFA_REQUIRED.BACKUPCODEmfa_required
MFA_REQUIRED.BACKUPCODE_DESCmfa_required
MFA_REQUIRED.FACEmfa_required
MFA_REQUIRED.FACE_DESCmfa_required
MFA_REQUIRED.PASSWORDmfa_required
MFA_REQUIRED.PASSWORD_DESCmfa_required
MFA_REQUIRED.PATTERNmfa_required
MFA_REQUIRED.PATTERN_DESCmfa_required
MFA_REQUIRED.PUSHmfa_required
MFA_REQUIRED.PUSH_DESCmfa_required
MFA_REQUIRED.TOTPmfa_required
MFA_REQUIRED.TOTP_DESCmfa_required
MFA_REQUIRED.FIDO2mfa_required
MFA_REQUIRED.FIDO2_DESCmfa_required
MFA_REQUIRED.VOICEmfa_required
MFA_REQUIRED.VOICE_DESCmfa_required
BACKmfa_required
CANCELmfa_required
MFA_REQUIRED.VERIFY_TOUCHIDmfa_required
ENTER_VERIFICATION_CODEmfa_required
INVALID_CODEmfa_required
MFA_REQUIRED.VERIFY_IVRmfa_required
MFA_REQUIRED.VERIFY_PATTERNmfa_required
ERROR_OCCURREDmfa_required
FOOTER.IMPRINT_LINK_LABELmfa_required
FOOTER.TOS_LINK_LABELmfa_required
FOOTER.POLICY_LINK_LABELmfa_required
MFA_REQUIRED.VERIFY_TOTPmfa_required
MFA_REQUIRED.VERIFY_PUSHmfa_required
MFA_REQUIRED.VERIFY_BACKUPCODEmfa_required
MFA_REQUIRED.VERIFY_FACEmfa_required
MFA_REQUIRED.VERIFY_PASSWORDmfa_required
AUTHENTICATED_REQUEST_DENIEDmfa_required
INVALID_USERNAME_PASSWORDmfa_required
NO_USER_FOUNDmfa_required

Translation and Language in the Hosted pages UI reference​

Here are the placeholders marked for you to check where excalty your editing.


MFAMFA
hosted-pages-image-reference-mfa-methodshosted-page-trans-image-reference-no-mfa-configuredhosted-page-trans-image-reference-auth-request-denied
hosted-page-trans-image-reference-verify-mfahosted-page-trans-image-reference-invalid-codehosted-page-trans-image-reference-sms-code
hosted-page-trans-image-reference-ivr-codehosted-page-trans-image-reference-password-verifyhosted-page-trans-image-reference-password-invalid
hosted-page-trans-image-reference-verify-backupcodehosted-page-trans-image-reference-verify-touchidhosted-page-trans-image-reference-verify-pattern
hosted-page-trans-image-reference-verify-totphosted-page-trans-image-reference-verify-facehosted-page-trans-image-reference-verify-push
hosted-page-trans-image-reference-no-user-foundhosted-page-trans-image-reference-error-occured

Translation and Language Hosted pages keys (Additional info)​


Label KeyPage reference
REGISTER.WELCOME_HEADERadditional_info
REGISTER.WELCOME_LABELadditional_info
SUBMITadditional_info
BACKadditional_info
ERROR.USER_WITH_THIS_DETAILS_ALREADY_EXISTSadditional_info
ERROR_OCCURREDadditional_info
ERROR.MSGadditional_info

Translation and Language in the Hosted pages UI reference​

Here are the placeholders marked for you to check where excalty your editing.


Additional informationAdditional information
hosted-page-trans-image-reference-additional-infohosted-page-trans-image-reference-additional-info-error-message
hosted-page-trans-image-reference-additional-info-user-exits

Translation and Language Hosted pages keys (Additional Register)​


Label keyValue
REGISTER.WELCOME_HEADERregister
REGISTER.WELCOME_LABELregister
WARNING.WARNINGregister
WARNING.WARNING_MESSAGE_FOR_BROKEN_REGISTRATION_FORMregister
REGISTER.AUTHENTICATION.TEXTregister
MFA_REQUIRED.PASSWORDregister
MFA_REQUIRED.EMAILregister
MFA_REQUIRED.SMSregister
MFA_REQUIRED.IVRregister
REGISTER.REGISTERregister
REGISTER.AUTHENTICATION.INFO_TEXTregister
BACKregister

Translation and Language in the Hosted pages UI reference​

Here are the placeholders marked for you to check where excalty your editing.


RegisterRegister
hosted-page-trans-image-reference-registerhosted-page-trans-image-reference-register-auth-infohosted-page-trans-image-reference-register-warning


LabelValue
CONSENT_PREVIEW.ASK_FOR_CONSENTconsent
CONSENT_PREVIEW.ACCEPTconsent
CANCELconsent
ERROR_OCCURREDconsent

Translation and Language in the Hosted pages UI reference​

Here are the placeholders marked for you to check where excalty your editing.


Consent
hosted-page-trans-image-reference-consent-previewhosted-page-trans-image-reference-consent-error

Need help implementing this?​

Please contact us on our Developer Support Page.