Quick Order Dictionary

The Quick Order dictionary holds all user-facing text, labels, and messages in the drop-in. Customize it to localize the drop-in, match your brand voice, or override default text without changing the drop-in source. Each string uses a unique key path under QuickOrder (i18n pattern).

How to customize

Override dictionary values during drop-in initialization. The drop-in deep-merges your values with the defaults. Include only the keys you want to change.

import { initializers } from '@dropins/tools/initializer.js';
import { initialize } from '@dropins/storefront-quick-order/api.js';

await initializers.mountImmediately(initialize, {
  langDefinitions: {
    default: {
      QuickOrder: {
        QuickOrderItem: {
          addAllToCart: 'Add All to Cart',
          emptyList: 'No products in the list',
        },
        CsvFileInput: {
          title: 'Add from File',
          downloadSample: 'Download sample',
        },
      },
    },
  },
});

For multi-language support and advanced patterns, see Dictionary customization.

Default keys and values

Override via langDefinitions in the initializer or via placeholders (for example, placeholders/quick-order.json in the boilerplate).

QuickOrder.Search

Key	Default (example)
placeholder	”Search by SKU…”
ariaLabel	”Search for products by SKU”
emptyState	”No results found”
resultsAvailable	”results available”
resultAvailable	”result available”
srInstructions	”Use arrow keys or Tab to navigate, Enter or Space to select, Escape to close.”

QuickOrder.SkuListInput

Key	Default (example)
title	”Add Products by SKU”
helperText	”Use commas or paragraphs to separate SKUs.”
textArea.label	”Enter Multiple SKUs”
textArea.placeholder	”Enter SKUs here…”
button	”Add to List”

QuickOrder.CsvFileInput

Key	Default (example)
title	”Add from File”
helperText	”File must be in .csv format and include “SKU” and “QTY” columns”
downloadSample	”Download sample”
inputLabel	”Choose File”
selectedFile	”Selected file”
uploadCSVErrors.invalidFile	”Invalid CSV file”
uploadCSVErrors.emptyFile	”File is empty”
uploadCSVErrors.missingColumns	”Must contain “SKU” and “QTY” columns”
uploadCSVErrors.extraColumns	”Must contain only “SKU” and “QTY” columns”
uploadCSVErrors.maxRowsExceeded	File exceeds maximum of {maxRows} rows
uploadCSVErrors.skuRequired	Row {rowNumber}: SKU is required
uploadCSVErrors.invalidQuantity	Row {rowNumber}: QTY must be a positive integer
uploadCSVErrors.noValidData	”File contains no valid data rows”
uploadCSVErrors.onlyCSV	”Only CSV files are allowed”
uploadCSVErrors.failedToRead	”Failed to read file”
uploadCSVErrors.failedToParse	”Failed to parse CSV file”

QuickOrder.QuickOrderItem

Key	Default (example)
title	”Enter SKU or search by Product Name”
quantity	”Quantity: “
price	”Price: “
sku	”SKU”
remove / removeItem	”Remove” / “Remove item”
showOptions / hideOptions	”Show additional options” / “Hide additional options”
additionalOptions / noAdditionalOptions	”Additional options” / “No additional options available”
emptyList	”No products in the list”
loading	”Loading…”
productNotFound	”Product not found”
productNotFoundDescription	The product with SKU {sku} could not be found
configurableProductError	”Configuration required”
configurableProductErrorDescription	”Use ProductOptions Slot in QuickOrderItems container to enable configurable product options.”
configurableOptionsWarning / configurableOptionsWarningDescription	”Product configuration required” / “Please select all required product options before adding to cart”
productOptions	”Product Options”
outOfStock	”Out of Stock”
addAllToCart	”Add to Cart”
disabledMessage	”Quick Order feature disabled”
notification.validationError	”Product(s) require your attention”
notification.backendError	”An error occurred while adding products to the cart”
notification.success	{count} product(s) successfully added to the cart
notification.partialSuccess	{count} of {total} products were added to the cart. Some products could not be added
notification.unexpectedError	”An unexpected error has occurred”

QuickOrder.VariantsGrid (Grid Ordering on PDP)

Key	Default (example)
imageColumn	”Image”
attributesColumn	”Attributes”
skuColumn	”SKU”
availabilityColumn	”Availability”
priceColumn	”Price”
minOrderColumn	”Min Order / Pack Size”
quantityColumn	”Quantity”
subtotalColumn	”Subtotal”
clearButton	”Clear”
saveToCsvButton	”Save to CSV”
collectDataButton	”Collect Data”
inStock / outOfStock	”In Stock” / “Out of Stock”
tableCaption	”Product Variants Grid”
quantityLabel	”Quantity for”
showAll / showLess	”Show All Items” / “Show Less”