Appearance
Theme the chat bar and panel, choose where ARCY sits and how it rests, write what the widget says, pick the starters, and set the languages ARCY speaks.
Settings > Appearance decides how the widget looks, what it says on its own and what languages it speaks. A Product holds several named themes, the one Default first. The brand theme and starters ARCY took from your site show From your site until you choose Keep or change them.
Before you start
- The admin role creates, edits and deletes. A member reads them without a save bar.
- The theme canvas needs a screen at least 768 px wide.
Themes and the theme canvas
A new theme takes a name of up to 100 characters. Each card's menu offers Make default, Rename and Delete. Delete is unavailable on the default theme and on the last one.
One sheet opens at a time: Colors, Sizes, Effects and Settings. Preview state renders the widget as a visitor meets it, from Bar only to Flow running. With two or more locales on the Language tab, it carries Language, which previews the panel in another language without saving.
New theme and Hand it to your agent sit at the head of the page while the Theme tab is open, and nowhere else. The hand-off opens ARCY MCP. A proposed theme is a tile marked Proposed; Accept creates it as a new theme, not the default, and Reject drops it.
Five facts the sheets do not show:
- Placement, the Sizes sheet's first Chat panel row, is Centre, Side panel or Corner, then a Side of Left or Right. A side panel and a corner panel stay open while ARCY acts on the page, folding for one step only when the control ARCY needs sits under them. Under Corner the preview's Bar only and Pinned states become one, Closed.
- Width and Max height are percentages of the visitor's screen, and the open bar takes the panel's width. Resting bar width is in pixels.
- The Welcome mark's image, size and inset also draw the pinned corner button, which takes the mark's Fill and corners until you set its own under Pinned button. Pick None when your mark carries its own background.
- When the canvas says your site runs an older arcy.js, newer settings wait for an update.
- Web fonts load from ARCY's servers and cover Latin Extended, not Cyrillic.
Texts
The Texts tab holds the three lines the widget says by itself, shared by every theme: Welcome headline and Welcome message, 100 characters each, and Input placeholder, 80 characters. An empty message shows no greeting.
Each is written twice, on the Signed-in users and Anonymous visitors tabs. Neither
falls back to the other; one save writes both. On Signed-in users, type {{ or press Insert
attribute to reference an attribute. Write words around the tag: a
visitor without that attribute gets nothing where it was, and a placeholder that renders
empty falls back to ARCY's own hint. On Anonymous visitors a reference is refused on save. Every
other Liquid construct works on both tabs.
These six texts are translatable on the Language tab; the rest of the widget's wording arrives translated.
A proposed widget copy shows above the fields as Proposed by your agent, each text against the current one; Accept applies it at once.
Starters
The Starters tab lists up to 5 items a visitor taps on the welcome screen, in your order. Signed-in users and Anonymous visitors each hold a list; one save writes both. Anything needing an account goes on the first list only.
- Add a prompt adds a line of up to 80 characters, translatable on the Language tab. Tapping it sends that text as the visitor's own message and spends a chat. An empty prompt blocks the save.
- A starter you added as a flow before still shows, marked Flow, and still runs when tapped. New ones are prompts.
- The lists are per Product. A flow starter whose flow is gone, or that no longer reaches this tab's audience, is marked. Remove it.
Settings and Visibility
The canvas's Settings sheet holds what a theme may not vary.
Three uploads, each saved the moment the file is chosen: Chat header logo, Welcome screen icon and Chat bar icon. PNG, JPEG, WebP or SVG. None falls back to another. Unset, the header shows your Product's name and the other two show ARCY's marks.
Visitors can attach images, off until you turn it on. A visitor then attaches up to ten PNG, JPEG or WebP images of up to 5 MB each to a message, through Add attachment, by dragging a file onto the chat or by pasting an image. Visitors can attach documents, also off until you turn it on, adds one PDF, DOC, DOCX, XLSX, CSV or TXT of up to 4.5 MB per message; untick the types you do not want. The file picker offers only the types you allow. Dragging shows a drop area inside the chat and never over your page. A file of a kind you did not allow gets one line naming the kinds the chat takes, and a chat with attachments off says it takes none. The agent reads a file on the message it arrives with and again on any later message while the file is kept, an image as well as a document, and a file sent with almost no words still reaches the right Procedure. A value it reads off a file is used as if the visitor had typed it and is not asked for again, and it is always shown on the approval card before anything is written, even for an Operation set to Runs without asking. A file's text is the visitor's data and never instructions; both appear on Conversations. A message holds 2,000 characters: the bar counts down from 1,600, and a longer paste is cut with one line saying so. Set your privacy policy URL on Legal first; the switch warns while it is empty. Retention is on Data retention.
How ARCY rests picks the shape a visitor meets: Chat bar or Pinned, a single button. Pinned shows above the button, as sentences, what the bar would show above itself: starter pills, a Checklist strip, a Pill offer, an Announcement. A visitor who pins or unpins keeps that choice in their browser only. A theme whose Placement is Corner answers this row instead: ARCY rests as the corner button, which opens the panel above itself and closes it on the next press, and Visitors can move the chat bar does not apply. The row says so while that theme is open, and your own choice returns with any other placement.
The Visibility tab holds two cards. Chat bar audience is Everyone, Identified only, Anonymous only or Nobody. A visitor outside it sees no bar at rest, yet ARCY still measures them and still offers and runs flows and Checklists, showing the bar only while it acts. Anonymous visitor redirect takes an optional Sign in page URL and Sign up page URL for every Product in your Workspace, offered as buttons to an anonymous visitor at their daily limit.
Language
The Language tab is where you enable a locale, translate every text a visitor reads, and set the fallback language. It applies to every environment, unlike the themes above it.
- Press New locale, pick the locale and press Create locale.
- Tell ARCY which locale each visitor is in. Six signals are read in a fixed order and the
first one you enabled wins: the language the visitor picked in the panel, a
locale_codeattribute inidentify(),contentLocaleinarcy.init(), thelangattribute on the page's<html>element,localeinarcy.init(), then Language below as the floor. A locale you have not enabled is skipped, so a visitor reading a German page gets your agent language rather than rows with no words in them. Regional forms work:de,de-ATandde_CHall read asde-DE. See Reference. - Under Agent language, set Language, the fallback for an unknown locale, and
Product time zone, the zone ARCY reads dates in for a visitor who did not share their
own. It starts at UTC (none set). Search it by city, by offset or by its IANA name;
rows are grouped by region and each reads its current offset, as in
(GMT+3) Istanbul. - In the Translation editor, pick the language and type a translation beside each English string, one card per group: the widget, each flow. Save the page; a refused string keeps your text and its reason under the field.
Clear a field and save to remove a translation. Save before you switch language.
Hand it to your agent opens Add your languages on ARCY MCP: your coding agent proposes your locales, the agent language and a draft for every missing string, each shown as Proposed by your agent.
What it changes
- A result ARCY looked up is laid out, never written as a table. An answer that is a list or a set of figures is drawn as cards with a picture, a table, headline figures, a value against its cap as a bar, a plain list, or two to four records side by side with their pictures. ARCY picks which and reflows it on a phone. The rows are the ones your operation returned (Endpoints), so a figure on screen is the figure your API gave. A table the assistant writes in its own words reads as one labelled block per row.
- A comparison, or three or more cards with pictures, widens the panel to 80% of the screen, at most 1,100 px, until the next answer without one. Under 640 px nothing changes.
- A question whose choices carry pictures shows them as cards to tap, two or three to a row.
- An image in an answer is a picture only from a host on your Image hosts list (Image hosts). Every other address stays a link. On a card, the field holds the address itself, never an object around it. A card grid and a record list both draw one.
- A card can open a page, and only one on a Domain you have verified. Return the page's
full
httpsaddress as a field of the operation and the whole card becomes a link to it, in the same tab. An address on another Domain, or longer than 2,048 characters, is dropped and the card still draws. - An answer keeps its line breaks, and a name out of your data is printed as written.
churn_risk_scorestays whole, and a formatting character inside a name is shown rather than obeyed. - Arrow Up in the message field brings back what the visitor typed before, in that conversation and that browser. Down walks forward, and past the newest it restores the draft they were writing. Escape closes the panel with the draft kept. A new chat starts empty, and a visitor's Forget clears it (What ARCY collects).
- Under a question ARCY asks, it offers up to three tappable replies. A tap sends the reply as the visitor's own message, and the visitor can always type instead: typing, or any new message, removes them. They show only under the latest answer. In Conversations you read which replies were offered and which one was tapped.
- A theme is saved, not published: no draft, no per-environment state.
- A visitor's widget reads its theme once per page load, so a save reaches them on their next page.
- Under 640 px wide the widget ignores the width settings: the bar is full width and the panel a full-screen sheet.
- Recent chats in the panel belong to the visitor's browser, not the id passed to
identify().
When it goes wrong
- The Signed-in users tab warns while identity checking is off: anyone can call
arcy.identify()with another person's id and read that copy with their attributes filled in. Turn it on under Identity verification before writing anything private.
See also
Persona
Write the one instruction field the agent reads for every visitor list the topics a person takes instead of the agent, and set the help link given when none can be reached.
Supervisor
Write the Restrictions the agent must never break, add exact values that catch them in any spelling, move a secret out of the Persona, and see what the Supervisor may change.