Appearance & customisation
Customise your widget's colours, name, avatar, welcome message, and conversation starters.
Updated 8 Oct 2026
The Appearance page lets you control how your chat widget looks and feels to visitors β without touching code.
Go to Dashboard β Appearance and select the chatbot you want to customise.
What you can customise
Chatbot name
The name shown in the chat header, next to your logo and the status line ("Replies instantly", or the live state when a person has taken over). Use your business name or a persona name (e.g. "Aria from Acme Plumbing"). Keep it short.
Welcome message
The first message visitors see when they open the widget. Make it friendly and action-oriented:
- "Hi! π I can answer questions about our services, pricing, and bookings."
- "G'day! Ask me anything about our solar packages."
Placeholder text
The greyed-out hint text inside the message input. Default: "Ask a questionβ¦"
Accent colour
The colour of the chat header, the launcher button, the send button, buttons and the visitor's messages. Text on it is set to white or near-black automatically so it stays readable on any colour. Click the colour swatch to open the colour picker, or enter a hex code directly (e.g. #C8922A).
Tip: use your brand's primary colour for a seamless embedded experience.
Avatar / logo
Paste the web address of a square image (PNG or JPG, at least 64Γ64px) in Logo URL. It appears in the chat header and next to the chatbot's messages. If not set, the widget shows the first letter of the chatbot's name. Available on Starter and above.
Show Pivra branding
Toggle the small "Powered by Pivra" link in the widget footer. Removing it is available on the Pro plan and above; on Free, Starter and Founding it is always shown.
Conversation starters
Before a visitor's first message, the widget shows tappable buttons. First come quick actions for what your chatbot can do, each shown only when it is turned on:
- Get a quote β opens your quote form (when quotes are enabled)
- Book a time β asks the chatbot for your booking link (when a booking integration is set up)
- Talk to a person β asks your team to take over (only when human handoff is set to Always show the option; by default the AI answers first and a person is offered when needed)
Then come your conversation starters: questions that send straight away when tapped. Add them under Settings β General β Conversation Starters. Up to 4 are shown. Examples for a tradie:
- "What areas do you service?"
- "How much does a call-out cost?"
- "Can I get a quote?"
- "Do you offer emergency repairs?"
On phones and for keyboard users
On screens up to 480px wide the chat opens as a full-screen sheet. With a keyboard, Tab moves between the widget's controls and Escape closes it; screen readers announce it as a dialog named after your chatbot.
Live preview
Changes are reflected in the live preview panel on the right as you type. The preview is interactive β you can test the widget before saving.
Click Save changes to apply. Changes take effect immediately on all embedded instances.
Advanced customisation (Pro+)
For deeper customisation, see Settings β White-label:
- Custom CSS β override widget styles using the stable class names listed in White label
- Allowed domains β choose which websites may show your chatbot
- Hide Pivra branding β remove the footer link entirely
- Custom domain β serve the embed from your own subdomain
Frequently asked questions
Can I have different colours per chatbot? Yes. Each chatbot has its own Appearance settings. Switch between chatbots using the selector at the top of the Appearance page.
My logo looks blurry. What size should I use? Use an image of at least 128Γ128px, ideally 256Γ256px. The widget shows it at up to 56Γ56px, and high-res screens need 2Γ the pixel density.
Can I change the widget position (left vs right)? Yes. Open Popup in the dashboard and set Bubble position to the left or right side of the screen. The default is bottom-right.
Was this helpful?
If you have questions or suggestions, email us at support@pivra.ai .