Customising the widget: texts, starters and installation

The chat widget is the fastest channel to switch on and the one most teams customise most. The settings live under Settings → AI assistant, split into five pages: Behaviour, Translations, Actions, Starters and Installation. This article covers the pages that change what visitors see.

Installation

The Installation page shows your client key and the snippet to paste before the closing tag of your site. There is a plain HTML version and a React or Next.js component. The page is also the widget's developer reference, with sections on:

Configuration (props): position, colours, default language and what the home screen shows.

Languages: which language the widget opens in.

Doc mode (inline assistant): embed the assistant inside a documentation page instead of as a floating bubble.

Page actions: client-side actions the assistant can call on your page, for example opening a dialog or pre-filling a form.

Error reporting: send front-end errors with the visitor's session so Starko AI has them when it fixes a bug.

Instance API: open, close and send messages to the widget from your own code.

Build your own help center (v1 API): fetch public articles and collections to render your own pages.

Secure identity: sign the user id so nobody can impersonate a logged-in customer.

ai settings installation

Translations

The Translations page holds every piece of text the widget shows: the greeting, button labels, the placeholder in the message box, the names of the Home, Inbox and Tickets tabs. Starko pre-translates them so the very first visitor in a language sees their own words. Add a language code and press Translate now, then correct anything you want phrased differently.

ai settings translations

Conversation starters

Starters are the suggested questions shown on the widget's home screen before a visitor types. Good starters are the three or four things people ask most, phrased the way they ask them.

ai settings starters

Collections in the widget

The widget's home screen lists your public Knowledge Hub collections so visitors can browse articles without asking. Keep collection names short and make sure the articles inside are published.

Look and tone

The widget colour follows your workspace colour under Settings → General.

The greeting, tone of voice and reply length are set on the Behaviour page, together with what the assistant does when it cannot help.

Testing changes

Open your site in a private window after saving. Text changes apply immediately. If you changed the greeting in several languages, switch your browser language to check each one.

Did this answer your question?