Skip to content
Adobe Commerce Storefront

Recommendations Dictionary

The Recommendations 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.1.1

Default keys and values

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

{
  "Recommendations": {
    "ProductList": {
      "addToCart": "Add To Cart",
      "selectOptions": "Select Options",
      "viewProduct": "View Product"
    }
  }
}

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


await initialize({
  langDefinitions: {
    en_US: {
  "Recommendations": {
    "ProductList": {
      "addToCart": "Custom string",
      "selectOptions": "Custom string"
    }
  }
}
  }
});