Skip to content
Adobe Commerce Storefront

Search is only available in production builds. Try building and previewing the site to test it out locally.

Checkout Dictionary

The Checkout 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.0

Default keys and values

Below are the default English (en_US) strings provided by the Checkout drop-in (72 keys):

{
  "Checkout": {
    "AddressValidation": {
      "title": "Verify your address",
      "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.",
      "suggestedAddress": "Suggested Address",
      "originalAddress": "Original Address"
    },
    "BillToShippingAddress": {
      "cartSyncError": "We were unable to save your changes. Please try again later.",
      "title": "Bill to shipping address"
    },
    "EmptyCart": {
      "button": "Start shopping",
      "title": "Your cart is empty"
    },
    "EstimateShipping": {
      "estimated": "Estimated Shipping",
      "freeShipping": "Free",
      "label": "Shipping",
      "taxToBeDetermined": "TBD",
      "withoutTaxes": "Excluding taxes",
      "withTaxes": "Including taxes"
    },
    "LoginForm": {
      "account": "Already have an account?",
      "ariaLabel": "Email",
      "emailExists": {
        "alreadyHaveAccount": "It looks like you already have an account.",
        "forFasterCheckout": "for a faster checkout.",
        "signInButton": "Sign in"
      },
      "floatingLabel": "Email *",
      "invalidEmailError": "Please enter a valid email address.",
      "missingEmailError": "Enter an email address.",
      "cartSyncError": "We were unable to save your changes. Please try again later.",
      "placeholder": "Enter your email address",
      "signIn": "Sign In",
      "signOut": "Sign Out",
      "switch": "Do you want to switch account?",
      "title": "Contact details"
    },
    "MergedCartBanner": {
      "items": {
        "many": "{{count}} items from a previous session were added to your cart. Please review your new subtotal.",
        "one": "1 item from a previous session was added to your cart. Please review your new subtotal."
      }
    },
    "OutOfStock": {
      "actions": {
        "removeOutOfStock": "Remove out of stock items",
        "reviewCart": "Review cart"
      },
      "alert": "Out of stock!",
      "lowInventory": {
        "many": "Only {{count}} left!",
        "one": "Last item!"
      },
      "message": "The following items are out of stock:",
      "title": "Your cart contains items that are out of stock"
    },
    "PaymentMethods": {
      "cartSyncError": "We were unable to save your changes. Please try again later.",
      "emptyState": "No payment methods available",
      "title": "Payment"
    },
    "PlaceOrder": {
      "button": "Place Order"
    },
    "ServerError": {
      "button": "Try again",
      "contactSupport": "If you continue to have issues, please contact support.",
      "title": "We were unable to process your order",
      "unexpected": "An unexpected error occurred while processing your order. Please try again later."
    },
    "ShippingMethods": {
      "cartSyncError": "We were unable to save your changes. Please try again later.",
      "emptyState": "This order can't be shipped to the address provided. Please review the address details you entered and make sure they're correct.",
      "title": "Shipping options"
    },
    "Summary": {
      "Edit": "Edit"
    },
    "TermsAndConditions": {
      "error": "Please accept the Terms and Conditions to continue.",
      "label": "I have read, understand, and accept our <a href='https://www.adobe.com/legal/terms.html' target='_blank'>Terms of Use, Terms of Sales, Privacy Policy, and Return Policy</a>."
    },
    "title": "Checkout"
  }
}

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-checkout';


await initialize({
  langDefinitions: {
    en_US: {
  "Checkout": {
    "AddressValidation": {
      "title": "Custom string",
      "subtitle": "Custom string"
    }
  }
}
  }
});