> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deeplink into the widget

> Open a widget deployment directly to a yield, a token, or a pending action using URL query parameters.

The [yield widget](/guides/widgets-dashboard/yield-widget) reads a set of query parameters from the page's own URL when it loads. Add them to the URL of a page where you've embedded the widget, for example your own site or a [Widget Pro](/guides/widgets-dashboard/yield-dashboard) deployment, to open it straight to a specific token, yield, or pending action instead of the default entry point.

<Note>
  There's no separate hosted yield.xyz app to link to: these parameters work on whatever URL your own widget deployment is served from.
</Note>

## Parameters

| Parameter | Effect |
| - | - |
| `network` | Preselects the network, alongside `token`. |
| `token` | Preselects the token on that network. |
| `yieldId` | Preselects the yield directly; takes priority over `token` when both resolve to different yields. |
| `pendingaction` | Opens the named pending action (for example `CLAIM_REWARDS`, `WITHDRAW`, `CLAIM_UNSTAKED`) for the connected wallet's position on `yieldId`, once the wallet is connected and owns that position. |
| `validator` | Narrows the pending action to a specific validator, for a validator-scoped balance. |
| `tab` | Opens a specific tab: `earn`, `positions`, `manage`, or `activity`. |

<Warning>
  The widget's own parameter is `validator`, not `validatoraddress`.
</Warning>

`pendingaction` values match the action `type` values returned in a balance's `pendingActions[]`; see [Balances and positions](/documentation/earn/core-concepts/balances-positions#pending-actions).

## Open a specific yield

```
https://your-app.example/stake?network=ethereum&token=ETH&yieldId=ethereum-eth-lido-staking
```

`network` and `token` alone preselect a token even without `yieldId`; add `yieldId` when you want a specific yield on that token preselected instead of the widget's default.

## Open a pending action

```
https://your-app.example/stake?network=cosmos&yieldId=cosmos-atom-native-staking&pendingaction=CLAIM_REWARDS
```

Add `validator` when the position is validator-scoped:

```
https://your-app.example/stake?network=cosmos&yieldId=cosmos-atom-native-staking&pendingaction=RESTAKE_REWARDS&validator=cosmosvaloper1yourvalidatoraddress
```

The widget only opens the pending action once its wallet connection resolves to the address that owns that position; deep-linking a pending action doesn't connect a wallet on its own.

## Next steps

<Columns cols={2}>
  <Card title="Embed the yield widget" icon="code" href="/guides/widgets-dashboard/yield-widget">
    Every prop the widget accepts.
  </Card>

  <Card title="Balances and positions" icon="wallet" href="/documentation/earn/core-concepts/balances-positions">
    Where pending action types come from.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.