> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/developer-reference/website-sdk/examples/price-conversion.md).

# Price Conversion

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

```javascript
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

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

### After widget load

```javascript
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

```javascript
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.

```javascript
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

```javascript
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);
});
```