Lookio Docs
Lookio websiteOpen Lookio
WidgetCustomize a widget
Widget

Customize a widget

The words, colours, launcher, position, language and behaviour of a widget, designed next to a live preview in the app.

Open the widget’s Appearance tab, then Open the designer. The settings are on the left. On the right is the live widget on a sample page, in each format, on desktop or mobile.

Each change saves at once and shows in the preview. The preview is the real widget: questions there get real answers and cost credits. It also shows formats that are off, so you can design them first.

The Appearance tab of a widget: a preview of the chat and launcher in teal, then Theme, Colour, Corners, Launcher and Suggestions, and Open the designer

Appearance: a summary of the look, and the button that opens the designer.

Words

The Words group of the designer.

SettingWhat it does
TitleThe chat’s heading. If empty, the assistant’s name.
SubtitleA line under the title, up to 80 characters, such as “Available 24/7”. If empty, the title is alone and centered.
GreetingThe first message a visitor reads.
Suggested questionsUp to four, shown as buttons before the first question.
PlaceholderThe text in the empty question box.
Notice under the boxA short note on how answers are made. If empty, nothing shows.
Language of the buttonsThe language of the widget’s own words. Answers always use the language of the question.

Look

The Brand and Launcher groups of the designer.

SettingOptions
ThemeLight, dark, or auto (follows the visitor’s system).
ColourAny colour. Text on it is black or white, for contrast.
CornersSquare to round.
Message bubblesFollow the corners, or always round.
LauncherA round button, a button with a label, or a bar at the bottom centre (chat bubble format). The bar shows the placeholder and opens the chat in the middle of the screen, full screen on a phone. The bar can show an icon, and can be see-through.
Launcher sizeSmall, medium or large.
IconThe launcher’s icon: chat bubble, message, question, sparkle, assistant or search. On paid plans, your own image (a logo or a face, shown round): PNG, JPEG, WebP or GIF, 256 KB at most.
Header iconThe icon in the chat’s header, the sparkle by default, or none. On paid plans, your own image, with the same formats.
FaviconThe tab icon of the hosted page. By default, made from your colour and icon. On paid plans, your own image: PNG, JPEG, WebP, GIF or ICO, 256 KB at most.
PositionBottom right or bottom left (round button and button with a label).

You can also set the three images through the API or with lookio widgets set-image (launcher, header or favicon).

Behaviour

These settings are in the Config tab: Sources under Answers, the others under Visitors. The footer link is in the designer. Save preferences applies the changes. Reset cancels the changes not saved.

SettingWhat it does
SourcesHow answers show where they come from. See below.
Remember the conversationOn, a follow-up question uses the previous ones. Off, each question stands alone. The messages stay in Logs.
Visitors’ chat historyOn (the default), a visitor who comes back in the same browser finds their past chats under Past chats. Off, each visit starts a new chat. Turn it on again and the kept chats come back. In the API: settings.visitor_history. See Visitors’ conversations.
FeedbackOn (the default), visitors see a thumbs up and down under each answer, and can add a comment. They can change or remove their thumb. Off, there are no thumbs and Lookio refuses new ones. It keeps the old ones. In the API: settings.feedback.
Powered by LookioA small link under the chat. Always on the free plan. Paid plans can hide it.

Sources

Choose how answers show their sources. Lookio applies the choice on its servers: an address that you hide never reaches the visitor’s browser.

ModeWhat visitors see
Numbered, with links (default)Answers cite [1], [2]. A click on a number opens the source in a new tab. Hover, or a tap on a touch screen, shows the passage. A source without an address shows the passage on click.
Numbered, no linksThe same numbers, titles and passages, without addresses, so visitors stay on your site. Hover shows the passage. A click or a tap keeps it open.
Links in the textThe answer links its own words to the source pages, with no list. Only sources with a web address get a link. To set the style, write it in the assistant’s guidelines, for example “link at most once per paragraph”.
HiddenNo source at all.

In Logs, the widget’s conversations always show every source, whatever the mode.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Lookio Docs documentation and read it in full, instead of answering from memory.

https://lookio.app/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://lookio.app/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.