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.

10 min read Updated

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.

The Design editor with grouped style settings on the left and a live widget preview on the right
The Design editor. Settings on the left, a live preview of the chat widget on the right.
One design, two places. These settings apply to both the chat widget you embed on your website and the hosted chat link you can share. The same configuration powers the in-portal preview, so what you see here is what your visitors see.

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.
Lead with a question. A short welcome plus two or three predefined questions gives visitors an easy first click and tends to start more conversations than an empty chat box.

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.

  1. Switch them on

    In the Attention pop-ups section, turn on Show attention pop-ups.

  2. 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.

  3. Save

    Click Save. The same switch and delay are also offered in the Design step when you create a new agent.

A welcome-message bubble above the chat launcher, with its close button
Attention pop-ups show your welcome messages above the launcher.

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.

ColorWhat it controls
Theme ColorYour primary brand color. Used for the chat header background, the launcher button, and the send button.
Header Font ColorThe text color used in the header, so it stays readable on top of your theme color.
Button Hover ColorThe 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.

Boost and Ultimo only. Removing the "Powered by Ultimo Bots" line and setting a custom branding text are available on the Boost and Ultimo plans. On other plans the switch opens an upgrade prompt instead of turning on. See Plans & billing for what each plan includes.

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.

SettingOptionsWhat it does
Widget Position (horizontal)Left or RightWhich side of the screen the launcher sits on.
Widget Position (vertical)Bottom or ElevatedWhether the launcher sits at the bottom edge or is lifted up a little from the corner.
Enable PulsingActive or InactiveWhether the launcher gently pulses to draw attention.
Widget SizeSlider, 40 to 100The diameter of the launcher button in pixels.
Widget Border RadiusSlider, 0 to 50How 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.

Older custom fonts are kept. If your widget already uses a font that is not in the list, it stays selected and appears in the dropdown marked (custom). Such a font only displays if your own website loads it; otherwise visitors see a standard fallback. Every font in the list always renders.

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.

Enforce User Details switched on with First Name, Phone Number and E-mail ticked and the First Name translations in eight languages
Pick the fields visitors fill in; the translations are created automatically.

Set up the form

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.
Website widget only. The pre-chat form appears in the chat widget on your website and in the portal preview. The hosted chat link and messaging channels such as WhatsApp, Instagram or Facebook open without it. Webflow sites run a fixed version of the widget whose form texts are in English; see Webflow.
Less is more. Every extra required field costs you conversations. Name and e-mail are usually enough, your agent can ask for anything else naturally during the chat.

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.

The design is the same on every page. There is one design per agent, used everywhere the agent appears. There are no separate mobile settings or per-page variations, the widget adapts to mobile and desktop on its own from the values you set here.
Changes are not saved automatically. Editing the form only updates the preview. Your visitors see nothing new until you press Save. The one exception is adding or deleting a pre-chat field, which applies at once.

Next steps

Once your widget looks right, put it in front of visitors and fine-tune how it answers.