# Custom Button

Give visitors a clear next step with a Help Page link or an interactive widget.

## Overview

QwryAI supports buttons in Help Page and in interactive widgets. Choose Help Page buttons for fixed navigation links, or create a widget when a button belongs to a conversational action.

## Add Help Page buttons

1. Open Channels → Help Page and choose Display.
2. Open Buttons and enable Primary button, Secondary button, or Link button.
3. Enter a label and destination URL for each enabled button.
4. For link buttons, add an optional description. You can add up to two link buttons.
5. Review the preview, save changes, and open the public Help Page to test the destinations.

| Field | Editor limit |
| --- | --- |
| Button label or link title | 120 characters. |
| Destination URL | 2,048 characters. |
| Link description | 200 characters. |

## Show a button in a conversation

Use Widget Studio to create the interface, then link it to a Show widget or Call API + show widget custom action. Configure when the action should run and test the button inside the target channel. For a button that needs your website's JavaScript, use a registered client-side action handler.

- [Widgets and response mapping](/docs/user-guides/actions/widgets)
- [Client-side actions](/docs/user-guides/actions/client-side-actions)

## Check the visitor experience

- Use a label that describes the destination or result.
- Open every link on desktop and mobile.
- Check keyboard focus and activation.
- Check both themes and avoid labels that truncate.
- Verify the published page after saving; an editor preview alone does not confirm the destination.

## Related guides

- [Help Page](/docs/user-guides/agent-management/help-page)
- [Widget Studio](/docs/user-guides/agent-management/widget-studio)
