Attributes for the widget's <script> tag. Only data-public-key (your public key
from the dashboard) is required.
Set in the dashboard
Website widget → Appearance overrides these once the widget loads.
| Attribute |
What it does |
Default |
data-title |
Name in the header |
Kothok |
data-logo |
http(s):// or data:image/ URL |
Kothok mark |
data-color |
Accent colour, hex or rgb()/rgba() |
#4F46E5 |
data-theme |
light, dark or brand |
light |
data-position |
bottom-left or bottom-right |
bottom-right |
data-greeting |
The first message shown |
Hi 👋 How can I help you today? |
data-placeholder |
Text in the message box |
How can we help? |
data-home-links |
Up to five Label\|https://url or Label\|mailto:address, separated by ; |
None |
Layout and behaviour
| Attribute |
What it does |
Default |
data-subtitle |
Line under the name |
Replies instantly |
data-offset-x |
Pixels from the side, 0 to 200 |
20 |
data-offset-y |
Pixels from the bottom, 0 to 200 |
20 |
data-open |
true opens the chat when the page loads |
false |
data-landing |
First screen: chat, home or messages |
chat |
data-promo |
false turns off the pop-up bubble |
on |
data-promo-title |
Pop-up bubble title and home screen hello |
Hi there! 👋 |
data-promo-text |
Text of the pop-up bubble |
Ask me anything. I'm here to help. |
Home screen
| Attribute |
What it does |
Default |
data-home |
false hides the home screen |
on |
data-home-heading |
Heading on the home screen |
How can we help you today? |
data-cta |
The main button text on the home screen |
Send us a message |
data-tabs |
false hides the bottom navigation |
on |
data-history |
false hides the visitor's past conversations |
on |
Feedback and advanced
| Attribute |
What it does |
Default |
data-feedback |
false hides the rating card at the end of a chat |
on |
data-fonts |
false uses system fonts |
on |
data-sync-tabs |
true syncs the chat across tabs |
false |
data-nonce |
CSP nonce for injected styles. See Security. |
None |
data-api-base |
Backend origin, for testing on a localhost page. Ignored on live sites. |
https://backend.kothok.ai |
data-debug |
true logs to the browser console |
false |
Example
<script
src="https://static.kothok.ai/js/widgets.js"
data-public-key="YOUR_PUBLIC_KEY"
data-landing="home"
data-offset-y="80"
async>
</script>