Page Widgets

What are Page Widgets?

Page Widgets are lightweight, focused engagement tools that appear on specific pages of your website. Unlike the full chat widget, each one is designed for a single purpose: answering a knowledge base question, starting a text, scheduling a call, or routing a visitor to the right team instantly.

You can place multiple different widgets on different pages — each completely independent.

Widget types

Click-to-Text — shows a "Text us" button. When clicked, the visitor enters their phone number and a message is sent to your SMS inbox in Velaro.

Click-to-Call — shows a "Call us" button with your phone number. Tapping on mobile starts a phone call directly.

Topic Chat — shows a small chat panel pre-configured for a specific topic (e.g. "Get a demo", "Billing help"). Routes directly to the right team.

Product Inquiry — lets a visitor ask about a specific product by name or SKU. The bot answers from your product catalog or hands off to a team.

KB Q&A — embeds a search box connected to your Velaro Knowledge Base. The visitor types a question and gets an instant answer from your published KB articles, without opening a full chat.

Creating a widget

1. Go to Designer → Page Widgets or Deployment → Page Widgets in the sidebar.

2. Click New Widget.

3. Choose a widget type.

4. Configure display name, position (bottom left/right), color, and type-specific options (team, phone number, KB index).

5. Optionally add Display Rules to control when and where it appears (see below).

6. Click Save — a widget ID is generated.

Installing a widget

Add this before the closing </body> tag on the target page:

<div data-velaro-widget="YOUR_WIDGET_ID"></div>

The widget renders floating in the corner. To show multiple widgets on the same page:

<script>
  window.VelaroWidgets = ['WIDGET_ID_1', 'WIDGET_ID_2'];
</script>

We recommend no more than 2 widgets on a single page.

Display Rules — controlling when the widget appears

Display Rules let you show a widget only when specific conditions are met. If no rules are set, the widget shows on every page where it is installed.

Condition types

Multiple conditions in one rule

Add multiple conditions to a single rule. All conditions are evaluated with OR — the rule matches if any condition is true.

Multiple rules

You can define several rules per widget. The first rule that matches is used. If no rules match, the widget is hidden.

Timing triggers (per rule)

Each rule can also delay when the widget appears:

• Show after (seconds) — widget waits this many seconds after the page loads before appearing. Set to 0 for immediate.
• Show after scroll % — widget waits until the visitor has scrolled this percentage of the page. Set to 0 to ignore scroll position.

If both are set, the widget appears when whichever trigger fires first.

KB Q&A widget details

The KB Q&A widget connects to your published Velaro Knowledge Base. When a visitor types a question:

1. The widget searches your KB articles using semantic matching.

2. The best-matching answer is shown inline.

3. If no answer is found, the visitor is offered a "Chat with us" fallback.

To use this widget, you must have at least one published Knowledge Base with indexed articles. Configure which KB index the widget searches in the widget settings.

Best uses for each widget type

Click-to-Text — mobile-optimized pages, service businesses, quick questions (hours, location, pricing)

Click-to-Call — pricing pages, demo request pages, high-intent enterprise pages

Topic Chat — support portals, documentation pages, pages where visitor intent is clear

Product Inquiry — product detail pages, search results pages

KB Q&A — help centers, FAQ pages, documentation sites where visitors self-serve

Analytics

Widget interactions appear in Reports > Conversations with the source tagged as the widget name. Use the Channel filter to see performance per widget.