> 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: observeState(observer: observeStateCallback)

# Method package: wixDashboard

# Method menu location: wixDashboard --> observeState

# Method Link: https://dev.wix.com/docs/velo/apis/wix-dashboard/observe-state.md

# Method Description:

Defines a callback function that receives changes to the state of a dashboard page's environment.

> **Note:** This function can only be used in page code files for dashboard pages created in the [Wix Editor](https://support.wix.com/en/article/velo-working-with-dashboard-pages) or with [Wix Blocks](https://support.wix.com/en/article/wix-blocks-creating-and-managing-blocks-dashboard-pages).

Use the data passed to `observeState()`'s  callback function to dynamically update a dashboard page's content.

The callback function passed to `observeState()` is triggered when the dashboard page is initialized and every time it's updated.



# Method Code Examples:

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

## Receive state data and log it to the console

```javascript
import { observeState } from 'wix-dashboard';

// ...

observeState((pageParams, environmentState) => {
  console.log('custom param', pageParams.customParam);
  console.log('locale', environmentState.locale);
});
```

---