The website chat widget
that installs in one line.

How do I add a chat widget to my website?

You paste one script tag before your closing body tag and set a data-project attribute to your project slug. The widget loads asynchronously, renders a floating launcher button, and starts answering visitors immediately from your knowledge base.

There is no SDK to install, no build step, and no framework requirement. It works on any site that can include a script tag: plain HTML, WordPress, Shopify, Webflow, Next.js, anything.

Will the chat widget break my site's CSS?

No. The widget is isolated with Shadow DOM, so its styles cannot leak into your page and your page styles cannot leak into it. Your typography, resets, and utility classes stay untouched.

It also coexists with other embeds on the same page, including HelpYap's own social proof widget, without z-index or style conflicts.

How does the AI answer visitors in the widget?

Replies stream in token by token, the way modern AI chat feels, instead of making visitors wait for a full response. The AI answers only from your knowledge base content, detects the visitor's language automatically, and hands off to your team when it judges a human is needed.

When a conversation escalates, the widget captures the visitor's email so your team can follow up even after they leave the page. Visitors can also rate conversations, and those ratings feed your CSAT analytics.

• Streaming AI replies grounded in your docs
• Escalation to your team with email capture
• Conversation ratings that feed CSAT reporting
• Optional pre-chat form to collect name and email up front

What can visitors do inside the widget?

The widget is a small messenger, not a single chat window. A tab bar gives visitors a home screen, their message threads, and a help tab, and the home screen includes a search box that queries your hosted help center directly.

Visitors can attach files up to 5 MB, images and PDFs, so a screenshot of the bug or a copy of the invoice arrives with the conversation instead of in a follow-up email.

• Home, messages, and help tabs
• In-widget help center search
• File uploads up to 5 MB, images and PDF
• Message history restored across visits

Can the widget do more than answer support questions?

Yes. The same widget carries your outreach: in-widget announcements for product news, and engagement guides that walk users through your product with checklists, tours, modals, and push prompts.

A proactive greeting bubble opens the conversation before the visitor clicks anything, which is where a lot of first conversations start.

Does the chat widget work well on mobile?

Yes. On phones the widget goes full screen and uses the visualViewport API to handle the on-screen keyboard, so the input never hides behind it and the conversation stays readable while typing.

Sessions persist in localStorage, so a visitor who closes the tab and comes back later picks up the same conversation.

How do replies arrive in real time?

The widget holds a server-sent events connection, so agent replies and AI messages appear the moment they are sent. If the connection cannot be established, it falls back to polling automatically, so delivery works behind strict proxies and firewalls too.

Typing indicators run in both directions: your team sees the customer typing, and the customer sees your agent typing.

Can I make the widget match my brand?

Yes. You set the accent color, the position on screen, the assistant avatar, and your logo from project settings, with no code changes and no redeploy.

On the Business plan you can remove the Powered by HelpYap footer entirely for a fully white-labeled widget.

• Custom accent color and screen position
• Your own avatar and logo
• Custom greeting text
• White label on Business