Skip to content

Launcher Button Builder

HolderChat user guide

Documentation

Summary

The launcher is the button visitors click to open the chat. In Widget Appearance you can choose an icon, upload your own image, set size and position, pick a hover or entrance animation, and optionally show a short teaser bubble next to the button. These settings are stored as sanitised values for that bot. They apply to both the script embed and the iframe embed. There is no free JavaScript field in the button builder.

Where to find it

  1. Open Dashboard and edit the bot
  2. Go to the Widget Appearance tab
  3. Use the colour scheme, the icon library or upload, and the size, offset, animation and teaser fields
  4. Click Save appearance

The live preview in that tab shows your bot name, avatar, welcome message, and the current button settings.

Colour scheme and launcher icon

Six colour schemes are available: Coral (the default), Mint, Ocean blue, Midnight, Violet, and Graphite. The scheme styles the chat window. A matching smiling-bot launcher icon is used when the icon source is set to Auto, unless you have a custom chatbot avatar or you pick another icon.

You can also pick a library icon, or upload a PNG, JPG, WebP, GIF, or SVG image (maximum 1 MB). Uploaded SVG files are sanitised to remove scripts and event handlers. Only the bot’s own admin can upload an image, and it is stored on holderchat.com.

Size, position, and shape

  • Size — button size, from 40 to 160 pixels (default 64)
  • Side — bottom right or bottom left
  • Offset X / Offset Y — distance from the chosen corner, 0 to 120 pixels
  • Circle — Auto, on, or off. Library icons stay uncapped unless you turn the circle on. A custom uploaded image can be shown as a circle
  • Flip — mirror the artwork horizontally

Animation

  • On hover — None, Lift, Pulse, or Wiggle
  • When it appears — None, Fade, Pop, or Slide in

If the visitor’s browser requests reduced motion, the widget does not play the hover loop.

Teaser bubble

You can show a short message next to the button, for example a name and a one-line prompt. The title has a 40-character limit and the text has an 80-character limit. You can delay the teaser (0 to 8,000 ms) and optionally show a green online dot. On small screens the title is hidden so the bubble stays compact.

Delayed load

Optionally load the widget after the host page is idle, waiting at most a number of milliseconds you set (0 to 15,000, default 3,000). This can reduce work during the first paint of your page. It does not change how the button looks once it appears.

What is stored

HolderChat stores only a fixed set of parameters: icon source, image URL, side, offsets, size, circle mode, hover and entrance names, flip, teaser fields, online dot, and deferral. Unknown keys are dropped. This is not a place to paste custom scripts. If you need CSS or JavaScript, use the iframe embed and the custom CSS and JavaScript fields, which run only inside the isolated iframe.

Related topics