Design
The Design editor controls how your AI agent looks and greets visitors on your site: its colors, header, welcome messages, attention pop-ups, starter questions, launcher button, images, font, and an optional pre-chat form. A live preview on the right shows every change before you save.
You reach the Design editor by opening an agent in the dashboard and choosing Design. The page is split in two: a column of settings grouped into collapsible sections on the left, and a live Preview of your widget on the right. Nothing goes live until you press Save, so you can experiment freely.

Messages and starter questions
The top of the editor controls the words your agent shows before a conversation begins. These are the first things a visitor reads, so keep them short and welcoming.
- Header Text. The title shown at the top of the chat window, for example Chat with us. Up to 60 characters.
- Welcome Messages. One or more greetings shown when the chat opens. Add up to three; each can be up to 300 characters. They are also the text of the attention pop-ups.
- Attention pop-ups. Show your welcome messages as bubbles above the launcher after a delay. See Attention pop-ups below for exactly when they appear.
- Predefined Questions. Ready-made questions a visitor can click instead of typing. Add up to three, each up to 40 characters. They are a good fit for your most common requests.
- Input Placeholder. The hint text inside the message box before a visitor starts typing, for example Type your message.... Up to 40 characters.
Attention pop-ups
Attention pop-ups bring your welcome messages to the visitor instead of waiting for a click on the launcher. They are available on every plan.
Switch them on
In the Attention pop-ups section, turn on Show attention pop-ups.
Set the delay
Enter the Delay in seconds, the time between the page loading and the first bubble appearing. The field only shows while the switch is on.
Save
Click Save. The same switch and delay are also offered in the Design step when you create a new agent.

What visitors see
- After the delay, your Welcome Messages (up to three) appear one after another as bubbles above the launcher, about a second apart.
- Clicking a bubble opens the chat. If you require the pre-chat form, the visitor sees the form first.
- A small × button above the bubbles closes them all.
- The bubbles follow the launcher: left or right, and higher up when the launcher is elevated.
- There are no other triggers. The widget does not react to scrolling or to a visitor about to leave, and it never opens the chat window by itself.
How often they appear
The pop-ups show once per page view. They come back on the next page view only until the visitor interacts with the widget.
Once the visitor opens the chat, clicks a bubble, or closes the bubbles with ×, no pop-ups appear again in that browser tab until the tab is closed. A new tab starts fresh.
So a visitor who ignores the bubbles sees them again on every page they open. A visitor who has dealt with them once is not interrupted again in the same tab. If the visitor opens the chat before the delay is over, the bubbles do not appear at all.
On mobile
On screens up to 768 pixels wide the behavior is the same, with slightly smaller bubbles. Opening the chat from a bubble or the launcher shows the chat full screen.
Messages from a live agent
A separate kind of bubble appears when a visitor has minimized the chat and a team member writes in a live chat: the new message shows as a short preview bubble above the launcher (up to three at a time), and the launcher shows an unread count. Clicking a preview opens the chat. This happens whether or not attention pop-ups are switched on. See Live inbox.
Colors
Match the widget to your brand with three color pickers. There are no preset themes or a dark mode toggle, so you choose each color yourself.
| Color | What it controls |
|---|---|
| Theme Color | Your primary brand color. Used for the chat header background, the launcher button, and the send button. |
| Header Font Color | The text color used in the header, so it stays readable on top of your theme color. |
| Button Hover Color | The color buttons change to when a visitor hovers over them. |
Branding
The Branding section has the switch Remove "Powered by Ultimo Bots". Turning it on removes the Ultimo Bots line from the bottom of the chat. A Custom branding text field then appears: enter up to 80 characters to show your own line instead (for example Powered by Acme Inc.), or leave it empty to show nothing.
Widget placement and behavior
The Widget section controls the launcher, the small button visitors click to open the chat, and where it sits on the page.
| Setting | Options | What it does |
|---|---|---|
| Widget Position (horizontal) | Left or Right | Which side of the screen the launcher sits on. |
| Widget Position (vertical) | Bottom or Elevated | Whether the launcher sits at the bottom edge or is lifted up a little from the corner. |
| Enable Pulsing | Active or Inactive | Whether the launcher gently pulses to draw attention. |
| Widget Size | Slider, 40 to 100 | The diameter of the launcher button in pixels. |
| Widget Border Radius | Slider, 0 to 50 | How rounded the launcher corners are. 50 makes it a full circle, 0 makes it a square. |
Images and font
You can replace the default visuals with your own and pick the typeface the widget uses. There are three image slots, each with an upload and crop step.
- Widget Icon. Replaces the default chat bubble on the launcher button that visitors click to open the chat.
- Header Logo. Your company logo, shown at the top of the chat window.
- Avatar Icon. A small image shown next to each reply from your agent, which makes the conversation feel more personal.
- Font Family. Pick a font from the dropdown. There is no field for typing your own font name.
After you pick an image, a cropper opens so you can frame it. You can re-open the cropper to adjust an image later, and it remembers your previous crop. There is one crop shape for all three slots.
Link behavior
The Link Behavior section has a single switch: Open links in new tab. When it is on, any link in your agent's answers opens in a new browser tab so visitors keep their place in the conversation. When it is off, links open in the same tab.
Enforce User Details (pre-chat form)
The Enforce User Details section puts a short contact form in front of the chat. When it is on, visitors on your website fill in the details you selected before they can start chatting, so you always have their information upfront, even if they leave after a single question.

Set up the form
Turn on Require user details to enable chat
A checklist appears under Select which details users must provide before start chatting. The first time you switch it on with nothing ticked, every field is ticked for you.
Tick the fields visitors must fill in
Every ticked field is mandatory. If no field is ticked, the form is not shown at all. Each field has two icons: Translations to check or correct its label in each language, and to delete it after a confirmation. Deleting removes the field for good; to stop asking for it, untick it instead.
Add fields with the + button
The button opens Add Parameter with Parameter Name (the internal key, letters and underscores), Parameter Description, and Display Name (for users), the label visitors see (up to 30 characters). Under Show some examples you can add First Name, Last Name, E-mail, Phone Number, or Company Name with one click on Use. A new field shows a spinner for a few seconds while it is saved and translated, then appears ticked.
Optional: the language note
Turn on Show the note “You can chat with us in any language.” to add that sentence (in the visitor's language) to the form.
Save
The switch, the ticks, the translations and the note are saved with Save, like every other design setting. Adding or deleting a field takes effect immediately, without Save.
What visitors see
When a visitor opens the chat, the form replaces the message box. It reads Before we start chatting and Please provide your details to continue, shows your ticked fields, and has a Start Chat button that stays disabled until every field is filled in. The E-mail field uses an e-mail input, so phones show the matching keyboard. After Start Chat, the chat opens with your welcome messages.
Languages
The form is shown in one of eight languages: German, English, French, Spanish, Italian, Portuguese, Dutch, or Polish. The widget picks the first of the visitor's browser languages it supports, otherwise the language of your web page, otherwise English. Field labels are translated automatically when you add a field. Open Translations on a field to correct a label; your corrections are kept. Whatever language the form showed, the answers are stored under the same field.
How often visitors fill it in
A visitor fills in the form only once per browser on your website. After a successful submit, the browser remembers it, across pages, tabs and future visits, and the form is not shown again.
It only comes back if the visitor clears their browser data, or used a private window that has since been closed. Starting a new chat does not show it again.
Where the answers go
- A lead. Each submit creates a lead in Activity → Leads, before the visitor has sent a single message. If the same chat session submits again, the same lead is updated instead of a new one being created.
- A notification. A new lead triggers the New lead generated notification, by e-mail and on the other channels you chose in the Notification center. The usual New chat started notification fires as well.
- Your agent. The details are added to the conversation, so your agent already knows who it is talking to.
Live preview and saving
The Preview on the right updates as you edit, so you can see your colors, text, launcher, and images in a realistic chat window before anything goes live. The preview can show your widget on top of a captured image of your own website. Use Take new screenshot to refresh that background if your site has changed or none has been captured yet.
When you are happy, click Save to publish your changes to the live widget and hosted chat link. If you make a change and then leave without saving, the editor warns you and offers a Discard Changes option so you do not lose work or publish by accident.
Next steps
Once your widget looks right, put it in front of visitors and fine-tune how it answers.