# In-app help widget

> Add a Help button to your app or site with one script tag. It suggests articles for the current page, searches the rest and opens any article from a link.

URL: https://office.greatwork.company/kb/features/help-widget
Last updated: 2026-11-21

One script tag adds a Help button that suggests articles for the page someone is on and opens any article in place.

## What readers get

A Help button in the corner of your app or site, in your brand color. It opens a panel with articles suggested for the current page, a search box, the full article inside the panel (with an Open in new tab link) and a Contact us option.

## The right articles for each page

Write rules like *URL contains /billing* shows **Failed payments**, **Change your plan** and **Download a receipt**. Rules can match exactly, by containing, or with a regular expression. Pages without a rule get suggestions from their title and path.

## Open an article from your own buttons

Add `data-kb-article="failed-payments"` to any link or button and it opens that article in the panel. Or use the JavaScript API: `KB.open()`, `KB.search("shipping")`, `KB.close()`, and `KB.identify({ email, name })` to prefill the contact form.

## Small

The loader is a few kilobytes with no dependencies and the panel loads only when someone clicks Help, so it doesn't slow your app down.

## Example: Contextual help on a billing page

A SaaS team pastes the script tag into its app layout and adds one rule: *URL contains /settings/billing* shows three billing articles. Next to the card field they add a small *What's this?* link with `data-kb-article="failed-payments"`. A customer whose card was declined clicks it, reads the fix inside the panel and never opens a ticket.

## How to set it up

1. Open Settings, then Widget, and copy the script tag.
2. Paste it before the closing body tag of your app or site.
3. Pick position, label and color.
4. Add suggestion rules for your most visited pages.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
