> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: onPropsChanged(handler: onPropsChangedHandler)

# Method package: widget

# Method menu location: widget --> onPropsChanged

# Method Link: https://dev.wix.com/docs/velo/velo-only-apis/$widget/on-props-changed.md

# Method Description:

Adds an event handler that runs when the value of a widget property is changed.

A widget receives an `onPropsChanged` event when one or more of its properties is changed via its API.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Load updated data when a widget's property is changed

```javascript
$widget.onPropsChanged((oldProps, newProps) => {
  loadProductData(newProps.productId);
  loadCustomerData(newProps.customerId);
});
```

---