Customize the Chat Panel and Branding
When a visitor clicks your chat launcher, the full conversation panel opens. In JIVIQ, you can configure your visitor-facing display name, custom workspace panel colors, HTTPS panel logo, 10 MB image and PDF file attachment controls, message notification chime, and Chat Studio identity settings directly in the admin dashboard.
Panel Customization Summary
Display Name (Max 60)
Header title shown to visitors. Defaults to your Workspace name if left blank.
Panel Color vs Launcher
Panel color controls the open header and buttons per Workspace. Launcher color is account-wide.
HTTPS Panel Logo
Accepts a hosted image URL. Automatically falls back to a clean initials letter circle if blank.
10 MB Attachments
Supports images and PDFs up to 10 MB each. Enabled by default with a toggle control.
Chat Panel & Branding
Setting the Display Name (Max 60 Chars)
The display name is the primary title anchored at the very top of the expanded chat window. It introduces your organization to the visitor the instant the panel opens.
60 Character Limit
You can enter up to 60 characters. Keep it clear and recognizable (e.g., "Acme Studio Support" or "James Davis Consulting").
Workspace Name Fallback
If you leave the display name field empty, JIVIQ automatically displays your Workspace name so the header is never blank.
Independent of Internal Naming
Changing the display name updates visitor-facing text only. Internal team dashboards, logs, and account billing preserve your core workspace identity.
Configuring Panel Header & Button Color
The panel color defines the background of the open chat header and styles interactive conversation buttons (such as submit and suggestion pills).
| Setting | What It Controls | Configuration Scope |
|---|---|---|
| palette Panel Color | Open chat panel header background and interactive action buttons. | Configured per Workspace |
| touch_app Launcher Color | Circular launcher button in the website corner. | Account-wide setting |
Workspace-Level Color Isolation
In JIVIQ, the launcher button color is account-wide for website consistency, but the panel color is configured per individual Workspace. If your organization manages two distinct workspaces (such as sales and customer support), each workspace can display its own branded panel theme.
To customize the circular button itself, see Customize the Chat Launcher.
Adding Your Panel Logo via HTTPS URL
The round avatar anchored in the panel header displays your brand mark. To ensure seamless performance and CDN caching, JIVIQ links directly to a hosted image URL.
Host Your Logo on a Secure Server
Ensure your logo is hosted on a secure web server or CDN with an https:// URL. The existing logo file already on your website is ideal.
Paste the URL into the Panel Logo Field
In Settings → Chatbox Widget (or Chat Studio), locate the Panel logo field and paste your secure image URL.
Verify in the Admin Preview
The admin preview canvas updates immediately. Verify that your logo renders clearly inside the circular container. Square or circular images with transparent backgrounds look best.
HTTPS Image Link Requirement
JIVIQ does not currently offer a local desktop file-upload button for the panel logo. You provide the URL of an existing hosted image. For example: https://example.com/logo.png (note that example.com is an illustrative placeholder, not a JIVIQ endpoint). Insecure http:// links are blocked by modern browsers due to mixed-content security policies.
Logo Comparison: Hosted Logo vs. Letter Circle Fallback
If no usable panel logo is displayed, JIVIQ can show the documented initials/letter-circle fallback:
JIVIQ Panel Logo Comparison
A. Hosted Logo Active
When a valid HTTPS image link is provided in the Panel logo field, JIVIQ loads your hosted logo directly inside the circular header avatar.
B. Letter Circle Fallback
If no usable panel logo is displayed, JIVIQ can show the documented initials/letter-circle fallback (e.g., JD for James Davis).
Letter Circle Fallback
If no usable panel logo is displayed, JIVIQ can show the documented initials/letter-circle fallback so visitors always see a clean, recognizable identity mark in the chat header.
File Attachments Rules (Images & PDFs, 10 MB)
Customer support frequently requires exchanging visual screenshots, design briefs, receipts, or spec sheets. JIVIQ provides streamlined visitor attachment support:
| Property | Verified Behavior | Configuration Notes |
|---|---|---|
| toggle_on Default Status | Enabled by default | Toggle off under panel settings to completely hide the paperclip attachment icon in the visitor composer. |
| perm_media Allowed Formats | Images & PDFs | Images and PDFs are supported, up to 10 MB per file. |
| data_usage Size Limit | 10 MB per attachment | Files exceeding 10 MB trigger an in-chat notification instructing the visitor to compress or resize the file. |
Message Notification Sound
JIVIQ respects visitor browsing habits by keeping message audio strictly optional:
Off by Default
The message sound setting is turned off by default. When activated, JIVIQ plays a subtle audio chime if a visitor receives an incoming reply while browsing another section of your website with the chat panel closed or minimized.
If the visitor already has the chat panel open and focused, the audio chime is suppressed so visitors are not disturbed while reading live messages.
The Chat Studio Identity Tab
In Chat Studio, the dedicated Identity tab controls how your AI assistant and organization present themselves to website visitors:
| Identity Setting | Verified Behavior | Configuration Options |
|---|---|---|
| smart_toy Assistant name | The name the AI assistant signs replies with. If left blank, it uses the Workspace name. | Custom text (Leave blank for Workspace name fallback) |
| domain Workspace name | The business identity visitors see in the chat experience, including in the AI disclosure line. | Workspace business identifier |
| record_voice_over Tone | How the assistant sounds. Adjusts response wording and conversational style only—never the factual knowledge it answers with. | Professional, Friendly, or Matter-of-fact |
| support_agent Who answers first | Controls the operational mode determining whether AI or team members handle incoming chats first. | Autopilot (AI answers on its own), Copilot (AI drafts for team review), or Off (humans only) |
Detailed AI Mode Guidance
For comprehensive instructions on configuring AI routing behaviors, escalation rules, and draft reviews, consult Choosing Your AI Mode or read the technical developer specifications in AI Modes Documentation.
Admin Navigation & Team Roles
JIVIQ provides two administrative interfaces depending on account age, protected by role-based access controls:
Classic Interface Navigation
In classic accounts, navigate to Settings → Chatbox Widget to configure display names, panel colors, logo links, attachments, and sound.
Chat Studio Navigation
In newer accounts, open Chat Studio in the left admin sidebar to access dedicated tabs for panel styling, wording, and assistant identity.
Owner & Admin Permissions
Only Workspace Owners and Admins can change these Chat Widget settings.
Saving, Publishing & Propagation Authority
After changing your Chat Panel settings, follow the preview and publishing steps in Preview, Publish & Troubleshoot Widget Changes. That guide covers draft states, the 1-minute caching lifecycle, allowed domains, and CSP headers.
For developer embed parameters and script tokens, consult the official Customize Widget Developer Documentation and Install Widget Documentation.
Frequently Asked Questions
Explore answers regarding panel display names, custom workspace branding, HTTPS logo links, letter circle fallbacks, and 10 MB attachment rules.
The display name field supports up to 60 characters. It appears prominently at the very top of the open chat panel where visitors first look when beginning a conversation.
If the display name field is left blank, JIVIQ automatically displays your Workspace name as the default header title so visitors always see a recognized organization name.
The Assistant name is the specific identity the AI assistant signs replies with (leaving it blank uses the Workspace name). The Workspace name is the business identity visitors see in the chat, including in the AI disclosure line.
The panel color controls the open chat panel's header background, action buttons, and send icons. It establishes your primary brand presence whenever the widget is expanded.
The launcher button color applies globally across your website for the closed chat button, whereas the panel color is configured per Workspace. This allows multi-brand organizations to run distinct workspace themes while maintaining uniform site buttons.
The panel color styles the top header banner of the open chat window, active send buttons, and interactive choice pills.
In the Panel logo setting, paste a secure, publicly accessible HTTPS image link pointing to your hosted logo file (for example, https://example.com/logo.png). JIVIQ renders this image inside the circular header avatar.
No. JIVIQ requires an existing hosted HTTPS image URL rather than an uploaded local file. You can easily use your existing website logo URL or a CDN link.
If no usable panel logo is displayed, JIVIQ can show the documented initials/letter-circle fallback (e.g., 'James Davis' displays 'JD').
Yes. The 'Allow file attachments' setting is enabled by default. Visitors can click the paperclip attachment icon inside the composer to share files with your team.
Images and PDFs are supported, with a maximum size of 10 MB per file.
The message sound is off by default. When enabled, JIVIQ plays a subtle, pleasant audio chime when a new agent or AI reply arrives while the chat panel is minimized or closed.
Only Workspace Owners and Admins can change these Chat Widget settings.
The Identity tab configures the Assistant name, Workspace name, Tone (Professional, Friendly, or Matter-of-fact), and Who answers first (Autopilot, Copilot, or Off).
For complete details on AI modes, see Choosing Your AI Mode (/help/workspace-setup/choosing-your-ai-mode) and AI Modes (/help/workspace-setup/choosing-your-ai-mode). To preview drafts and publish changes, see Preview, Publish & Troubleshoot Widget Changes (/help/chat-customization/preview-publish-and-troubleshoot).