Price Conversion

Customize how product prices are displayed in the Alhena chat widget using convert price hooks.

The convert price hook lets you transform product prices before they are displayed in product cards. The hook function receives the original price and a metadata object, and should return the formatted price string.

Hook Signature

function convertPrice(price, metadata) { ... }

Argument	Type	Description
price	string	The original product price (e.g., "$29.99")
metadata.variantId	string | undefined	The external variant ID of the product

Setting the Hook

There are two ways to set the hook:

At initialization

document.gleenConfig = {
  company: "your-company-key",
  apiBaseUrl: "https://app.alhena.ai",
  convertPrice: function (price, metadata) {
    return price;
  },
};

After widget load

window.gleenWidget.setConvertPriceHook(function (price, metadata) {
  return price;
});

Use setConvertPriceHook when the hook needs to be set or updated dynamically after the widget has loaded.

Examples

Currency Conversion

window.gleenWidget.setConvertPriceHook(function (price, metadata) {
  const amount = parseFloat(price.replace(/[^0-9.]/g, ""));
  const converted = (amount * 0.85).toFixed(2);
  return "€" + converted;
});

Variant-Aware Pricing

Use metadata.variantId to show different prices per product variant — for example, sale prices or region-specific pricing.

const salePrices = {
  "variant-123": "$19.99",
  "variant-456": "$24.99",
};

window.gleenWidget.setConvertPriceHook(function (price, metadata) {
  if (metadata.variantId && salePrices[metadata.variantId]) {
    return salePrices[metadata.variantId];
  }
  return price;
});

Locale-Based Formatting

window.gleenWidget.setConvertPriceHook(function (price, metadata) {
  const amount = parseFloat(price.replace(/[^0-9.]/g, ""));
  return new Intl.NumberFormat("de-DE", {
    style: "currency",
    currency: "EUR",
  }).format(amount * 0.85);
});