User Auth Dictionary

The User Auth dictionary contains all user-facing text, labels, and messages displayed by this drop-in. By customizing the dictionary, you can:

Localize the drop-in for different languages and regions
Customize labels and messages to match your brand voice
Override default text without modifying the drop-in’s source code

Dictionaries use the i18n (internationalization) pattern, where each text string is identified by a unique key path.

Version: 2.1.5

Default keys and values

Below are the default English (en_US) strings provided by the User Auth drop-in (73 keys):

1
{
2
  "Auth": {
3
    "PasswordValidationMessage": {
4
      "chartTwoSymbols": "Use characters and numbers or symbols",
5
      "chartThreeSymbols": "Use characters, numbers and symbols",
6
      "chartFourSymbols": "Use uppercase characters, lowercase characters, numbers and symbols",
7
      "messageLengthPassword": "At least {minLength} characters long"
8
    },
9
    "ResetPasswordForm": {
10
      "title": "Reset your password",
11
      "buttonPrimary": "Reset password",
12
      "buttonSecondary": "Back to sign in",
13
      "formAriaLabel": "Reset your password form"
14
    },
15
    "SignInForm": {
16
      "title": "Sign in",
17
      "buttonPrimary": "Sign in",
18
      "buttonSecondary": "Sign up",
19
      "buttonTertiary": "Forgot password?"
20
    },
21
    "SignUpForm": {
22
      "title": "Sign up",
23
      "buttonPrimary": "Create account",
24
      "buttonSecondary": "Already a member? Sign in",
25
      "keepMeLoggedText": "Keep me logged in after account creation",
26
      "failedCreateCustomerAddress": "Failed to create customer addresses:",
27
      "confirmPassword": {
28
        "placeholder": "Confirm password",
29
        "floatingLabel": "Confirm password *",
30
        "passwordMismatch": "Passwords do not match. Please make sure both password fields are identical."
31
      }
32
    },
33
    "UpdatePasswordForm": {
34
      "title": "Update password",
35
      "buttonPrimary": "Update password"
36
    },
37
    "FormText": {
38
      "requiredFieldError": "This is a required field.",
39
      "numericError": "Only numeric values are allowed.",
40
      "alphaNumWithSpacesError": "Only alphanumeric characters and spaces are allowed.",
41
      "alphaNumericError": "Only alphanumeric characters are allowed.",
42
      "alphaError": "Only alphabetic characters are allowed.",
43
      "emailError": "Please enter a valid email address.",
44
      "dateError": "Please enter a valid date.",
45
      "dateLengthError": "Date must be between {min} and {max}.",
46
      "dateMaxError": "Date must be less than or equal to {max}.",
47
      "dateMinError": "Date must be greater than or equal to {min}.",
48
      "urlError": "Please enter a valid URL, e.g., https://www.website.com.",
49
      "lengthTextError": "Text length must be between {min} and {max} characters."
50
    },
51
    "EmailConfirmationForm": {
52
      "title": "Verify your email address",
53
      "subtitle": "We`ve sent an email to",
54
      "mainText": "Check your inbox and click on the link we just send you to confirm your email address and activate your account.",
55
      "buttonSecondary": "Resend email",
56
      "buttonPrimary": "Close",
57
      "accountConfirmMessage": "Account confirmed",
58
      "accountConfirmationEmailSuccessMessage": "Congratulations! Your account at {email} email has been successfully confirmed."
59
    },
60
    "Notification": {
61
      "errorNotification": "Your password update failed due to validation errors. Please check your information and try again.",
62
      "updatePasswordMessage": "The password has been updated.",
63
      "updatePasswordActionMessage": "Sign in",
64
      "successPasswordResetEmailNotification": "If there is an account associated with {email} you will receive an email with a link to reset your password.",
65
      "resendEmailNotification": {
66
        "informationText": "This account is not confirmed.",
67
        "buttonText": "Resend confirmation email"
68
      },
69
      "emailConfirmationMessage": "Please check your email for confirmation link.",
70
      "technicalErrors": {
71
        "technicalErrorSendEmail": "A technical error occurred while trying to send the email. Please try again later."
72
      }
73
    },
74
    "SuccessNotification": {
75
      "headingText": "Welcome!",
76
      "messageText": "We are glad to see you!",
77
      "primaryButtonText": "Continue shopping",
78
      "secondaryButtonText": "Logout"
79
    },
80
    "Api": {
81
      "customerTokenErrorMessage": "Unable to log in. Please try again later or contact support if the issue persists."
82
    },
83
    "InputPassword": {
84
      "placeholder": "Password",
85
      "floatingLabel": "Password *"
86
    }
87
  }
88
}

How to customize

You can override any of these dictionary values by creating a custom dictionary file and loading it during drop-in initialization. The drop-in will automatically deep-merge your custom values with these defaults.

For complete step-by-step instructions, see the Dictionary customization guide.

Quick example:

1
import { initialize } from '@dropins/storefront-auth';
2

3
await initialize({
4
  langDefinitions: {
5
    en_US: {
6
  "Auth": {
7
    "PasswordValidationMessage": {
8
      "chartTwoSymbols": "Custom string",
9
      "chartThreeSymbols": "Custom string"
10
    }
11
  }
12
}
13
  }
14
});