Branding, Menu & Dark Mode

Branding

Logo and Bot avatar are the first two rows of the Widget section on Brand → (your brand) → Chat widget → Design. Both open the same shared picker, a modal titled "Your images": "Everything this organization has uploaded. Pick one to reuse it, or add a new one." Uploading through it adds the file to the library, so the same logo never has to be uploaded twice.

Logo

"Shown at the top of the Home screen." Your logo sits at the top-left of the Home screen, on the same row as the language button and the close button, and it scrolls away with the content. Pick one from the library or upload a PNG, JPEG or WebP image. If no logo is chosen, nothing is shown there — the widget never puts Yaplet's logo in its place, and a new widget starts without one.

The logo is drawn small, so a wide mark with a transparent background reads best. It sits directly on the Home screen background — when that reaches the whole screen it is your brand color, so check the logo against a dark and a bright background.

Bot Avatar

"The picture next to the AI's replies." The bot avatar is the widget's own face: the small picture beside every AI reply in the chat, the large one on the empty chat screen, the picture in the chat header while no person is assigned, and the picture on the Home screen's open-conversation card when the AI wrote last. It is shown in a circle, so a square picture works best. Until you choose one — and a new widget starts without one — the widget draws the launcher's AI mark on your brand color in its place, never a Yaplet image.

Removing an Image From the Library

Removing an image from the library never breaks a live picture. If anything is still showing it, only the listing is removed and the file itself is kept, with the message "The file itself was kept — either something is still showing it, or it predates your library." If nothing is using it, the file is genuinely deleted. There is also a per-organization ceiling; reaching it gives "Your image library is full — delete an image before adding another."

"Powered by Yaplet"

A thin line — a small bolt and Powered by Yaplet — closes the Home screen's content and sits under the chat composer. Turning it off needs the Remove branding add-on, or a plan that includes it — that is what grants the Brands.Branding right.

The switch is called Hide Branding — "Remove the 'Powered by Yaplet' badge." — and it sits in the Home screen settings on Brand → (your brand) → Chat widget → Home
It appears only for organizations whose plan or add-on includes Remove branding; without it the switch is not shown at all and the line stays

Brand Logo vs Widget Logo

These are two different pictures. The brand's logo (Brand settings → Brand images) is what appears at the top of the public knowledge base, documentation and roadmap pages. The widget's logo, set here, is what appears inside the chat panel.

The Floating Dock

The navigation is a pill floating just above the bottom edge of the panel — icons only, with the active tab widened into a tinted pill that also shows its name. Content scrolls under it and dissolves as it passes. There are five possible tabs:

Tab	Icon	Can it be hidden?
Home	House	No
Messages	Chat bubble	No — chatting is what the widget is for
Help	Question mark	Yes — Features tab → Help
News	Newspaper	Yes — Features tab → News Feed
Roadmap	Map	Yes — Features tab → Roadmap

Because Home and Messages are always present, the dock is always there. It hides itself while the visitor is reading a knowledge-base or news article, while a form is open and on the Messages tab itself, where the composer needs the room.

A red badge on the Messages icon counts unread replies. When the Home screen background reaches the Whole screen, the dock on Home takes the background's surface color so its icons stay readable on it; everywhere else it is a solid pill on the page color, with a thin edge and a soft shadow. Its corners follow the Corners setting — only Pill makes it fully round.

Show or Hide Tabs

Each optional tab has a Show on Navbar switch in its own section of the designer's Features tab: Help, News Feed and Roadmap. The Messages tab has no switch.

A tab that is switched on stays in the dock whether or not it has anything to show, so check its source as well as its switch. The Help tab's content depends on whether the brand's public web address has a knowledge base on it — not on any widget-level setting. The Roadmap tab depends on a roadmap board picked on the widget itself; that picker is the only content picker left on the widget.

Tab Names

The tab names are Yaplet's own — Home, Messages, Help, News, Roadmap — and each visitor reads them in the language the widget is showing. There is no field to rename a tab — no Menu Title field on any tab. See Widget Languages for how the widget picks its language.

Launcher Position and Icon

Which corner the launcher sits in (Bottom Right or Bottom Left) and which icon it shows (Message Bubble or AI Icon) are the first two rows of the Launcher section on the Design tab. Its colors, its shape and its highlight ring are covered in Launcher Button.

Dark Mode

The widget has no dark-mode switch and does not follow the visitor's system setting; a dark widget is simply a widget whose Widget color is dark. To make one:

Pick a dark widget color

In the Widget section choose Slate, Graphite or Ink, or type any dark color. The widget solves light text, light hairlines and matching surfaces for it, and checks every pair for readability.

Or start from a dark starting point

Starting points offers five dark ones — Midnight, Terminal, Twilight, Ember and Aurora — each setting the whole look at once: colors, Home background, cards, corners and bubble.

Check how far the background reaches

With Reaches: Whole screen the Home background covers the entire Home screen — in your brand color when the Color layer is Solid or Gradient — and the text on it uses the ink solved for that background, not for the dark page. The preview shows both at once.

The brand's public pages — knowledge base, documentation and roadmap — take the same theme, so a dark widget gives you dark public pages without a second setting.