User Account Dictionary

The User Account 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: 1.2.0

Default keys and values

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

1
{
2
  "Account": {
3
    "minifiedView": {
4
      "CustomerInformation": {
5
        "containerTitle": "Account settings",
6
        "genderMale": "Male",
7
        "genderFemale": "Female",
8
        "changePassword": {
9
          "passwordValidationMessage": {
10
            "chartTwoSymbols": "Use characters and numbers or symbols",
11
            "chartThreeSymbols": "Use characters, numbers and symbols",
12
            "chartFourSymbols": "Use uppercase characters, lowercase characters, numbers and symbols",
13
            "messageLengthPassword": "At least {minLength} characters long",
14
            "passwordMismatch": "Passwords do not match. Please make sure both password fields are identical",
15
            "incorrectCurrentPassword": "The current password you entered is incorrect. Please check and try again.",
16
            "passwordUpdateMessage": "Your password has been updated"
17
          },
18
          "containerTitle": "Change password",
19
          "currentPassword": {
20
            "placeholder": "Password",
21
            "floatingLabel": "Password"
22
          },
23
          "newPassword": {
24
            "placeholder": "New Password",
25
            "floatingLabel": "New Password"
26
          },
27
          "confirmPassword": {
28
            "placeholder": "Confirm new password",
29
            "floatingLabel": "Confirm new password"
30
          },
31
          "buttonSecondary": "Cancel",
32
          "buttonPrimary": "Save"
33
        },
34
        "customerInformationCard": {
35
          "buttonSecondary": "Change password",
36
          "buttonPrimary": "Edit",
37
          "accountCreation": "Account creation date"
38
        },
39
        "editCustomerInformation": {
40
          "containerTitle": "Edit details",
41
          "buttonSecondary": "Cancel",
42
          "buttonPrimary": "Save",
43
          "accountSuccess": "Your account information has been updated.",
44
          "accountError": "Your account information has not been updated.",
45
          "passwordField": {
46
            "placeholder": "Password",
47
            "floatingLabel": "Password"
48
          }
49
        }
50
      },
51
      "Addresses": {
52
        "containerTitle": "Addresses",
53
        "editAddressFormTitle": "Edit address",
54
        "differentAddressFormTitle": "Deliver to new address",
55
        "viewAllAddressesButton": "View address list",
56
        "differentAddressButton": "Use a different address",
57
        "ariaLabelAddressPicker": "form",
58
        "addressCard": {
59
          "actionRemove": "Remove",
60
          "actionEdit": "Edit",
61
          "cardLabelShipping": "Shipping",
62
          "cardLabelBilling": "Billing",
63
          "defaultLabelText": "DEFAULT",
64
          "ariaLabel": {
65
            "editButton": {
66
              "default": "Edit address",
67
              "shipping": "Edit default shipping address",
68
              "billing": "Edit default billing address",
69
              "shippingAndBilling": "Edit address set as default for both shipping and billing"
70
            },
71
            "removeButton": {
72
              "default": "Remove address",
73
              "shipping": "Remove default shipping address",
74
              "billing": "Remove default billing address",
75
              "shippingAndBilling": "Remove address set as default for both shipping and billing"
76
            }
77
          }
78
        },
79
        "removeAddressModal": {
80
          "title": "Remove address",
81
          "description": "Are you sure you would like to remove this address?",
82
          "actionCancel": "Cancel",
83
          "actionConfirm": "Remove"
84
        }
85
      },
86
      "OrdersList": {
87
        "containerTitle": "Recent orders",
88
        "viewAllOrdersButton": "View all orders",
89
        "ariaLabelLink": "Redirect to full order information",
90
        "dateOrderPlaced": "Date order placed",
91
        "OrdersListCard": {
92
          "orderNumber": "Order number:",
93
          "itemsAmount": "items",
94
          "carrier": "Carrier:",
95
          "returns": "Return(s):",
96
          "orderDate": "Placed on"
97
        },
98
        "OrdersListSelectDate": {
99
          "pastSixMonths": "Past 6 months",
100
          "currentYear": "Current year",
101
          "viewAll": "View all"
102
        }
103
      },
104
      "EmptyList": {
105
        "Addresses": {
106
          "message": "No saved addresses"
107
        },
108
        "OrdersList": {
109
          "message": "No orders"
110
        }
111
      }
112
    },
113
    "fullSizeView": {
114
      "Addresses": {
115
        "containerTitle": "Addresses",
116
        "editAddressFormTitle": "Edit address",
117
        "differentAddressFormTitle": "Deliver to new address",
118
        "newAddressFormTitle": "Add address",
119
        "addNewAddressButton": "Create new",
120
        "differentAddressButton": "Use a different address",
121
        "ariaLabelAddressPicker": "form",
122
        "addressCard": {
123
          "actionRemove": "Remove",
124
          "actionEdit": "Edit",
125
          "cardLabelShipping": "Shipping",
126
          "cardLabelBilling": "Billing",
127
          "defaultLabelText": "DEFAULT",
128
          "ariaLabel": {
129
            "editButton": {
130
              "default": "Edit address",
131
              "shipping": "Edit default shipping address",
132
              "billing": "Edit default billing address",
133
              "shippingAndBilling": "Edit address set as default for both shipping and billing"
134
            },
135
            "removeButton": {
136
              "default": "Remove address",
137
              "shipping": "Remove default shipping address",
138
              "billing": "Remove default billing address",
139
              "shippingAndBilling": "Remove address set as default for both shipping and billing"
140
            }
141
          }
142
        },
143
        "removeAddressModal": {
144
          "title": "Remove address",
145
          "description": "Are you sure you would like to remove this address?",
146
          "actionCancel": "Cancel",
147
          "actionConfirm": "Remove"
148
        }
149
      },
150
      "OrdersList": {
151
        "containerTitle": "Your orders",
152
        "ariaLabelLink": "Redirect to full order information",
153
        "dateOrderPlaced": "Date order placed",
154
        "OrdersListCard": {
155
          "orderNumber": "Order number:",
156
          "itemsAmount": "items",
157
          "carrier": "Carrier:",
158
          "returns": "Return(s):",
159
          "orderDate": "Placed on"
160
        },
161
        "OrdersListSelectDate": {
162
          "pastSixMonths": "Past 6 months",
163
          "currentYear": "Current year",
164
          "viewAll": "View all"
165
        }
166
      },
167
      "EmptyList": {
168
        "Addresses": {
169
          "message": "No saved addresses"
170
        },
171
        "OrdersList": {
172
          "message": "No orders"
173
        }
174
      }
175
    },
176
    "AddressForm": {
177
      "formText": {
178
        "secondaryButton": "Cancel",
179
        "primaryButton": "Save",
180
        "defaultShippingLabel": "Set as default shipping address",
181
        "defaultBillingLabel": "Set as default billing address",
182
        "saveAddressBook": "Save in address book"
183
      }
184
    },
185
    "FormText": {
186
      "requiredFieldError": "This is a required field.",
187
      "numericError": "Only numeric values are allowed.",
188
      "alphaNumWithSpacesError": "Only alphanumeric characters and spaces are allowed.",
189
      "alphaNumericError": "Only alphanumeric characters are allowed.",
190
      "alphaError": "Only alphabetic characters are allowed.",
191
      "emailError": "Please enter a valid email address.",
192
      "dateError": "Please enter a valid date.",
193
      "dateLengthError": "Date must be between {min} and {max}.",
194
      "urlError": "Please enter a valid URL, e.g., http://www.adobe.com.",
195
      "lengthTextError": "Text length must be between {min} and {max} characters."
196
    },
197
    "AddressValidation": {
198
      "title": "Verify your address",
199
      "subtitle": "To ensure accurate delivery, we suggest the changes highlighted below. Please choose which address you would like to use. If neither option is correct, edit your address.",
200
      "suggestedAddress": "Suggested Address",
201
      "originalAddress": "Original Address"
202
    }
203
  }
204
}

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-account';
2

3
await initialize({
4
  langDefinitions: {
5
    en_US: {
6
  "Account": {
7
    "minifiedView": {
8
      "CustomerInformation": {
9
        "containerTitle": "Custom string",
10
        "genderMale": "Custom string"
11
      }
12
    }
13
  }
14
}
15
  }
16
});