Cart Dictionary
The Cart 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.5.1
Default keys and values
Below are the default English (en_US) strings provided by the Cart drop-in (216 keys):
{ "Cart": { "Cart": { "heading": "Shopping Cart ({count})", "editCart": "Edit", "viewAll": "View all in cart", "viewMore": "View more" }, "CartSummaryTable": { "item": "Item", "price": "Price", "qty": "Qty", "subtotal": "Subtotal", "mobilePrice": "Price", "mobileQty": "Qty", "mobileSubtotal": "Subtotal" }, "MiniCart": { "heading": "Shopping Cart ({count})", "subtotal": "Subtotal", "subtotalExcludingTaxes": "Subtotal excluding taxes", "cartLink": "View Cart", "checkoutLink": "Checkout" }, "EmptyCart": { "heading": "Your cart is empty", "cta": "Start shopping" }, "PriceSummary": { "taxToBeDetermined": "TBD", "checkout": "Checkout", "orderSummary": "Order Summary", "giftCard": { "label": "Gift Card", "applyAction": "Apply", "ariaLabel": "Enter gift card code", "ariaLabelRemove": "Remove gift card", "placeholder": "Enter code", "title": "Gift Card", "errors": { "empty": "Please enter a gift card code." }, "appliedGiftCards": { "label": { "singular": "Gift card", "plural": "Gift cards" }, "remainingBalance": "Remaining balance" } }, "giftOptionsTax": { "printedCard": { "title": "Printed card", "inclTax": "Including taxes", "exclTax": "excluding taxes" }, "itemGiftWrapping": { "title": "Item gift wrapping", "inclTax": "Including taxes", "exclTax": "excluding taxes" }, "orderGiftWrapping": { "title": "Order gift wrapping", "inclTax": "Including taxes", "exclTax": "excluding taxes" } }, "subTotal": { "label": "Subtotal", "withTaxes": "Including taxes", "withoutTaxes": "excluding taxes" }, "shipping": { "label": "Shipping", "editZipAction": "Apply", "estimated": "Estimated Shipping", "estimatedDestination": "Estimated Shipping to", "destinationLinkAriaLabel": "Change destination", "zipPlaceholder": "Zip Code", "withTaxes": "Including taxes", "withoutTaxes": "excluding taxes", "alternateField": { "zip": "Estimate using country/zip", "state": "Estimate using country/state" } }, "taxes": { "total": "Tax Total", "totalOnly": "Tax", "breakdown": "Taxes", "showBreakdown": "Show Tax Breakdown", "hideBreakdown": "Hide Tax Breakdown", "estimated": "Estimated Tax" }, "total": { "estimated": "Estimated Total", "free": "Free", "label": "Total", "withoutTax": "Total excluding taxes", "saved": "Total saved" }, "estimatedShippingForm": { "country": { "placeholder": "Country" }, "state": { "placeholder": "State" }, "zip": { "placeholder": "Zip Code" }, "apply": { "label": "Apply" } }, "freeShipping": "Free", "coupon": { "applyAction": "Apply", "placeholder": "Enter code", "title": "Discount code", "ariaLabelRemove": "Remove coupon" } }, "CartItem": { "discountedPrice": "Discounted Price", "download": "file", "message": "Note", "recipient": "To", "regularPrice": "Regular Price", "sender": "From", "file": "{count} file", "files": "{count} files", "lowInventory": "Only {count} left!", "insufficientQuantity": "Only {inventory} of {count} in stock", "insufficientQuantityGeneral": "Not enough items for sale", "notAvailableMessage": "Requested qty. not available", "discountPercentage": "{discount}% off", "savingsAmount": "Savings", "includingTax": "Incl. tax", "excludingTax": "Excl. tax", "itemBeingRemoved": "\"{product}\" is being removed", "itemRemoved": "\"{product}\" was removed", "itemRemovedDescription": "Changed your mind? You can undo this action.", "undoAction": "Undo", "dismissAction": "Dismiss" }, "EstimateShipping": { "label": "Shipping", "editZipAction": "Apply", "estimated": "Estimated Shipping", "estimatedDestination": "Estimated Shipping to", "destinationLinkAriaLabel": "{destination}, Change destination", "zipPlaceholder": "Zip Code", "withTaxes": "Including taxes", "withoutTaxes": "excluding taxes", "alternateField": { "zip": "Estimate using country/zip", "state": "Estimate using country/state" } }, "OutOfStockMessage": { "heading": "Your cart contains items with limited stock", "message": "Please adjust quantities to continue", "alert": "Out of stock", "action": "Remove all out of stock items from cart" }, "GiftOptions": { "formText": { "requiredFieldError": "This field is required" }, "modal": { "defaultTitle": "Gift wrapping for Cart", "title": "Gift wrapping for", "wrappingText": "Wrapping choice", "wrappingSubText": "", "modalConfirmButton": "Apply", "modalCancelButton": "Cancel", "ariaLabelModal": "Gift modal", "ariaLabelModalOpen": "open", "ariaLabelModalClose": "close", "ariaLabelWrapping": "Wrapping options" }, "order": { "customize": "Customize", "accordionHeading": "Gift options", "giftReceiptIncluded": { "title": "Use gift receipt", "subtitle": "The receipt and order invoice will not show the price." }, "printedCardIncluded": { "title": "Include printed card", "subtitle": "" }, "giftOptionsWrap": { "title": "Gift wrap this order", "subtitle": "Wrapping option:" }, "formContent": { "formTitle": "Add a message to the order (optional)", "formTo": "To", "formFrom": "From", "giftMessageTitle": "Gift message", "formToPlaceholder": "Recipient's name", "formFromPlaceholder": "Sender's name", "formMessagePlaceholder": "Gift message" }, "readOnlyFormView": { "title": "Selected gift order options", "giftWrap": "Gift wrap this order", "giftWrapOptions": "Wrapping option:", "giftReceipt": "Use gift receipt", "giftReceiptText": "The receipt and order invoice will not show the price.", "printCard": "Use printed card", "printCardText": "", "formTitle": "Your gift message", "formTo": "To", "formFrom": "From", "formMessageTitle": "Gift message" } }, "product": { "customize": "Customize", "accordionHeading": "Gift options", "giftReceiptIncluded": { "title": "Use gift receipt", "subtitle": "The receipt and order invoice will not show the price." }, "printedCardIncluded": { "title": "Include printed card", "subtitle": "" }, "giftOptionsWrap": { "title": "Gift wrap this item", "subtitle": "Wrapping option:" }, "formContent": { "formTitle": "Add a message to the item (optional)", "formTo": "To", "formFrom": "From", "giftMessageTitle": "Gift message", "formToPlaceholder": "Recipient's name", "formFromPlaceholder": "Sender's name", "formMessagePlaceholder": "Gift message" }, "readOnlyFormView": { "title": "This item is a gift", "wrapping": "Wrapping:", "recipient": "To:", "sender": "From:", "message": "Message:" } } } }}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:
import { initialize } from '@dropins/storefront-cart';
await initialize({ langDefinitions: { en_US: { "Cart": { "Cart": { "heading": "Custom string", "editCart": "Custom string" } }} }});