Widget Customization
Launcher and Position
Control where the chat bubble sits on the screen and whether the availability tooltip shows.
The widget launcher is the floating button that sits in the corner of the screen. These settings are all under Settings → Apps → [your app] → Chatbox → Appearance.
Moving the launcher to the left
By default, the launcher sits in the bottom-right corner. To move it to the bottom-left, turn on:
Reverse the position of the chatbox (show on the left)
This is useful if other UI elements - live chat badges, cookie banners, or CTAs - conflict with the bottom-right position.
The reversed position applies on both desktop and mobile.
Availability tooltip
When Show the availability tooltip when chatbox is closed is on, a small tooltip bubble appears near the launcher when the widget is closed. It shows your team’s current availability status to visitors before they click.
Turn it off if you want a cleaner, quieter launcher.
Show app logo in the launcher
Turn on Show app logo in chatbox button to replace the default chat icon with your app’s logo. Your logo is set in your app’s general settings.
Hiding the launcher entirely
To hide the launcher on mobile, use Hide the chatbox on mobile devices under Settings → Apps → [your app] → Chatbox → Behavior.
To hide it on specific pages, use page rules under Settings → Apps → [your app] → Chatbox → Restrictions (allow or block by URL).
To open or close the chat window from your own code, use the JavaScript API:
Convot.open(); // open the chat window
Convot.close(); // close the chat window
Next steps
- Colors and branding - change the launcher color.
- Availability display - control what availability status visitors see.
- The widget on mobile - responsive and mobile behavior.
Was this article helpful?
Thanks for your feedback!