Make the widget and knowledge base look like you
Out of the box your chat panel says Chat in Replium's green, and your knowledge base is styled the same way. Two screens change that — and it is worth knowing which one owns what, because the split is not where most people guess.
| Screen | What it controls | Where it shows |
|---|---|---|
| Widget → Appearance | Title bar text, which corner | The chat widget |
| Branding | Accent colour | The chat widget and the knowledge base |
| Branding | Logo, browser tab icon, language | The knowledge base (language also everywhere else) |
The short version: the widget takes your colour and nothing else. Read on for why that matters.
Widget → Appearance
Two fields, and the section tells you the rule for both: leave one empty to keep the default.
Header title — the text in the panel's title bar, up to 60 characters. Empty means the default, which is the word for "Chat" in your workspace's language, not the English word. Long titles are shortened to fit: the panel is about 300 pixels wide, so anything near 60 characters is being trimmed on screen before a visitor reads it. "Acme Support" works; your full company name with a tagline does not.
Position — bottom right or bottom left. Those are the only two, and that is deliberate: a third option would mean arbitrary offsets and a differently-anchored panel, which is a different feature rather than another value in this list. Bottom left is the one to pick when your site already has something in the right corner — a cookie bar, a back-to-top button, another vendor's launcher.
That is the whole section. There is no field for the greeting, and this is the thing worth knowing before you go looking for it: the "Hi there! Ask us anything and we'll reply right here in this chat" that a visitor sees on an empty panel comes from your workspace's language, not from a setting. Same for every other word in the widget — the composer's placeholder, the History labels, the "message sent" line. If you need your own wording there, write to us; today it is not something you can change from the console.
Branding → Accent colour
One six-digit hex value, #7C3AED-shaped, and it is the single setting that reaches both audiences at once.
In the widget it colours the launcher button, the panel's header and the knowledge-base links inside the panel. In the knowledge base it colours links, the search field and the selected article in the menu.
Two things happen for free, and they are the reason a bad colour choice is hard to make here:
- Text and icons on the accent flip between white and near-black by themselves. Pick a pale brand colour and the widget does not become light-grey-on-white — the text goes dark instead. You are choosing one colour, not a colour and a matching text colour.
- The form shows you the contrast before you save, for text on the accent and for links on white. The preview only updates once the value is a valid hex, so a half-typed colour shows the previous state rather than nonsense.
Leave the field alone to keep Replium's green. There is no separate "reset" — the default is simply what an unset value means.
Branding → Logo and tab icon
Both are small files by design, and the limits are tighter than anywhere else in the product:
| Formats | Size on a side | Weight | |
|---|---|---|---|
| Logo | PNG, JPG, GIF, WEBP | up to 512 px | up to 256 KB |
| Browser tab icon | PNG, square | 16 to 512 px | up to 256 KB |
Why so much stricter than a chat attachment, which may weigh 5 MB? Because these two files are not documents. Every anonymous visitor of your knowledge base downloads them, on every page, so a browser can draw them at about 32 pixels — the logo in the header, the icon in the tab. A five-megabyte logo is not a large file, it is a slow page for someone else. A 512-pixel PNG with transparency is normally 15–60 KB, and a gradient-heavy one still under 150 KB, so 256 KB leaves real room.
The pixel cap is a separate rule from the weight cap, not a restatement of it: an image of one flat colour at 6000×6000 compresses to a few kilobytes and still costs the visitor's browser a great deal of memory to decode before shrinking it to 32 pixels.
A few details worth having:
- A transparent background works best for the logo — it sits on your knowledge base's own header.
- SVG is refused on purpose. That format can carry an executable script inside the file, and this one is served to the public.
- The logo has no shape rule. A wide wordmark is as valid as a square badge; the header takes whatever it is given.
- The tab icon must be square, checked with a little tolerance — an icon exported at 512×510 is accepted rather than rejected on a rounding error.
- If a file is refused, the reason appears in that field, in place of its hint, naming the actual size or weight of what you tried.
- A logo saved before these limits existed keeps working. Nothing was removed from anyone's workspace; the limits apply the next time you upload one.
Now the part that surprises people: neither of these appears in the chat widget. The panel a visitor opens on your site carries your accent colour, your title and a "Powered by Replium" line on the free plan — and no logo. The logo and the tab icon are your knowledge base's: the logo sits in its header, and the tab icon marks it in the browser tab and — if a visitor saves the knowledge base to their phone's home screen — on that shortcut too. A tab icon of 180 px or more stays sharp there. If you upload a logo and then go looking for it in the chat, it is not hiding: it was never sent there.
Branding → Language
One picker, and it decides more than it looks like: the chat widget's wording, these admin screens, your public knowledge base and the emails we send you all follow it. It is also what the widget's default header title is derived from.
The picker offers the languages available to your workspace. If you see only one, there is nothing to switch on and nothing is broken — that is the list your workspace has.
What a visitor actually sees
Worth walking once, because it is the shortest way to check your choices landed:
- The launcher sits in the corner you chose, in your accent colour.
- Opening it shows your header title, not "Chat".
- Text on the coloured header is readable — light on a dark accent, dark on a pale one.
- Your knowledge base at
your-workspace.replium.chat/kbshows your logo, and the browser tab shows your icon. - Links and the search field there are in your colour too.
Changes apply on the visitor's next page load. Nothing is cached against you, and there is no "publish" step for branding — saving is the whole of it.
The free plan's line
The widget's panel carries a small "Powered by Replium" at the bottom on the free plan. The paid plan removes it. It is the one piece of the panel that no setting on either of these screens controls.