Preview, Publish & Troubleshoot Widget Changes
Everything visitors see—the chat button, panel styling, wording, and logo—is managed directly in the admin app under Settings → Chatbox Widget (named Chat Studio on newer accounts) without touching your website code. Learn the difference between the instant admin preview and your live website, how classic auto-saving differs from Chat Studio publishing, how the 1-minute caching lifecycle works, and how to resolve domain or CSP issues when widget changes don't appear.
Deployment & Verification Summary
Admin Preview vs. Live
Preview shows your real-time draft. The live website serves saved or published settings cached on edge servers.
The 1-Minute Rule
Allow ~60 seconds for server and browser caches to update, then reload the webpage.
Domains & Strict CSP
Settings only reach approved domains and sites permitting connect-src https://widget.jiviq.com.
Preview Your Widget Changes
The preview canvas inside the JIVIQ admin updates continuously as you edit—it renders your active draft straight from your keyboard. Your live website follows a separate, high-performance delivery lifecycle.
| Environment | What It Shows | Visitor Visibility |
|---|---|---|
| desktop_windows Admin Preview | Your instant, real-time draft as you type. Shows changes immediately as you adjust launcher styling, panel branding, or wording copy. | Private to you. Visitors cannot see half-typed sentences, unverified hex colors, or test logo URLs. |
| public Live Website | The saved (classic) or published (Chat Studio) configuration distributed across edge servers. | Public to all visitors. Updates automatically once saved or published, after caching propagates and the page reloads. |
When the Two Disagree for a Minute
Seeing a change in the admin preview does not mean visitors can see it immediately. When the admin preview and your live site disagree for about a minute, the preview is ahead, not wrong. Live visitors only receive changes once the configuration is saved/published and local browser caching expires.
Save or Publish Your Changes
Accounts are moving to a newer settings surface called Chat Studio. Both live in the same sidebar spot—the entry reads Settings → Chatbox Widget on the classic version and Chat Studio on the newer one—and both control the exact same live widget, but they save differently:
Classic Chatbox Widget (Auto-Save)
The classic step-by-step wizard saves automatically. Every change saves itself approximately two seconds after you stop typing. A "Saved just now" indicator sits directly beneath the preview canvas.
Chat Studio (Draft & Publish)
Chat Studio holds your edits as a working draft until you click Publish. Nothing reaches visitors until you do. After publishing, you will see the official status: "Published — live for visitors in about a minute."
Team Roles & Permissions
Viewing widget settings is open to everyone on your team. However, saving appearance changes or adding website domains requires an Owner or Admin role on the account.
How Long Do Changes Take? (The 1-Minute Rule)
One thing to know up front, because it trips people up: your changes reach the live widget automatically, but not instantly.
JIVIQ Edge Server Cache (~1 Minute)
Settings are cached briefly on the way to your website. JIVIQ edge servers hold configuration snapshots for up to 60 seconds to ensure sub-second global widget delivery.
Visitor Browser Cache (~1 Minute)
The visitor's local web browser caches the previous look for up to another minute to avoid redundant network round-trips while browsing multiple pages on your site.
Page Reload Required
The JIVIQ widget initializes its settings when the webpage loads. An already-open page will not restyle itself in real-time. So: save or publish, wait about a minute, then reload your website (or press Cmd+Shift+R / Ctrl+F5).
Expected Behavior, Not Broken
If you checked your live website within 30 seconds of editing and did not reload the page, you haven't seen your change yet—that is completely expected, not broken.
Troubleshoot Widget Changes (5-Step Checklist)
"I changed the color and position and nothing happened" is the most common widget question we get. Work down this checklist in exact order—it is ordered by how often each one is the cause:
Give it about a minute, then reload the page
Settings pass through two short caches: our servers hold them for up to a minute, and the visitor's browser holds the previous look for up to another minute. Reload the page to fetch the new look.
In Chat Studio, did you click Publish?
Chat Studio keeps your edits as a draft. The admin preview updates instantly, which makes it easy to believe you're done—but visitors see nothing until you press Publish.
Is your website's domain on the allowed list?
The widget fetches your saved settings from JIVIQ servers, and that fetch only succeeds for websites on your list (Step 3 of the wizard, "Where will this appear?"—or "Websites that can show your chat" in Chat Studio). Off the list, the widget falls back to the look baked into the code when you pasted it, and no amount of waiting changes that.
Does your site set a Content-Security-Policy (CSP)?
A CSP missing connect-src https://widget.jiviq.com silently blocks the settings fetch. The button appears but keeps its pasted defaults. See the CSP section below.
Still stuck? Re-copy the snippet
The button's color, position, and icon also ride inside the pasted code as the "first paint" look, before live settings arrive. Copying a fresh snippet from Copy Widget Code and replacing the old one updates that baked-in look.
Settings saved to JIVIQ edge servers. Reload your live website after 60 seconds to view changes.
Websites that can show your chat
Check Your Website Domain ("Where will this appear?")
The JIVIQ chat widget only works on websites you have explicitly listed. Without your website's domain on the list, visitors won't be able to load your custom settings—the admin page warns you and disables the Copy button until at least one domain is added.
| Admin Surface | Exact UI Section Label | Where It Lives |
|---|---|---|
| Classic Interface | Step 3: "Where will this appear?" | Step 3 in the 4-step Chatbox Widget wizard |
| Chat Studio | "Websites that can show your chat" | Under the Install tab |
Official Allowed Domain Rules
Type your bare domain—yourbusiness.com, without https:// or any path—and click Add. If you paste a full address, the page asks you to remove the scheme and path. Keep these official rules in mind:
Public DNS Verification
JIVIQ verifies the domain exists using a public DNS check. If a domain is rejected, the page displays a "Why?" button with the exact explanation.
Local & Private Addresses Rejected
Localhost and private IP addresses are rejected—you cannot allow-list localhost or internal subnets. Test on your publicly accessible live or staging site instead.
Wildcards for Subdomains
yourbusiness.com and www.yourbusiness.com are separate entries. Use *.yourbusiness.com to automatically cover all subdomains in one single entry.
200 Domains Limit
The limit is 200 domains per account. Most accounts use one or two. Manage them anytime from Add Your Website Domain.
Pre-Embed "Test" Link
Each verified domain gets a Test link that opens a test page so you can see the widget running in your browser before you touch your website code.
Owner / Admin Role Required
Viewing the domain list is open to all team members, but adding or removing website domains requires an Owner or Admin role.
Check Your Content Security Policy (CSP)
Most websites do not set a Content-Security-Policy, and if yours doesn't, you can safely skip this section. If your website enforces a restrictive CSP, a policy that omits the JIVIQ widget's origin blocks it silently.
The Complete Official JIVIQ CSP Directives
If your site has a strict Content-Security-Policy header, add these three directives to permit the JIVIQ widget and its live settings fetch:
script-src https://widget.jiviq.com
frame-src https://widget.jiviq.com
connect-src https://widget.jiviq.com connect-src is the one teams frequently miss, and missing it fails partially and silently: the chat button still opens, but the button keeps its pasted default navy look instead of fetching your custom saved settings. The admin Copy-code step in Install Widget includes a "My site has a strict CSP" section with a quick copy button for these rules.
How to Inspect CSP Errors in Your Browser
Press F12 (or right-click and choose Inspect), then click the Console tab. If a CSP directive is missing, your browser will display an error: "Refused to connect to https://widget.jiviq.com because it violates the following Content Security Policy directive..."
Still Having Trouble? When to Re-Copy the Code
Under normal operations, once you paste the snippet into your website before the closing </body> tag, you never need to touch website code again. Appearance and behavior changes reach the widget automatically.
When Re-Copying the Snippet Is Appropriate
The chat button's color, position, and icon also ride inside the pasted snippet as the "first paint" look, before live settings arrive over the network. Copying a fresh snippet from Copy Widget Code and replacing the old code updates that baked-in initial appearance immediately.
This is a last resort, not the standard path—if you find yourself re-pasting for every routine edit, your website domain or CSP headers are misconfigured.
Important: Always copy the code from the JIVIQ admin rather than retyping it manually. The data-tenant and data-capability attributes are specific to your account, and a single typo means the widget silently will not load.
Still stuck? Our support team is ready to inspect your configuration: email support@jiviq.com.
Frequently Asked Questions
Explore answers regarding admin preview vs. live behavior, Chat Studio publishing, the 1-minute caching rule, allowed website domains, and CSP header troubleshooting.
The admin preview inside JIVIQ reflects your real-time draft as you type from your keyboard. Your live website, however, serves the last saved or published configuration cached across edge servers. During the 1-minute caching window, the admin preview is simply ahead of your live site.
No. Edits made in Chat Studio remain private working drafts. Visitors continue seeing your last published widget configuration until you click the Publish button.
The Chat Studio preview is specifically designed for visual styling (launcher position, colors, wording, and logo). To test live AI grounding, use the Inbox or open the widget on your verified live site.
In the classic Chatbox Widget interface, changes save automatically roughly two seconds after you stop editing, displaying a 'Saved just now' indicator. In Chat Studio, changes remain as working drafts until you click the Publish button.
The Publish button is located in the top-right header of the Chat Studio interface. When unpublished draft edits exist, the button becomes active with a draft status indicator.
Once you click Publish, Chat Studio displays the official confirmation notice: 'Published — live for visitors in about a minute.'
Changes take approximately one minute to reach live visitors. Settings pass through two short caches: JIVIQ's servers hold them for up to a minute, and the visitor's browser holds the prior look for up to another minute.
The JIVIQ widget fetches its configuration when the webpage initializes. An already-open browser tab will not restyle itself in real-time. You must reload your webpage to fetch the updated configuration.
A standard reload fetches the page HTML, while a hard reload (Ctrl+F5 on Windows or Cmd+Shift+R on macOS) forces the browser to bypass its local HTTP cache and request fresh assets directly from the server.
In the classic wizard, domain settings are located in Step 3 labeled 'Where will this appear?'. In Chat Studio, navigate to the Install tab under 'Websites that can show your chat'.
When you add a domain, JIVIQ performs a public DNS check to confirm the hostname exists. If rejected, a 'Why?' explanation button appears detailing the DNS error. Localhost and private IP addresses are automatically rejected.
Each JIVIQ account can allow-list up to 200 domains. Root domains and subdomains are distinct entries (yourbusiness.com vs www.yourbusiness.com), but wildcard patterns (*.yourbusiness.com) authorize all subdomains at once.
If your website enforces a strict CSP, add script-src https://widget.jiviq.com, frame-src https://widget.jiviq.com, and connect-src https://widget.jiviq.com. Missing connect-src silently blocks settings from loading while allowing the button to render in its default colors.
The initial position, color, and icon are baked into the snippet as the first-paint look to prevent layout shift. Re-copying the snippet from Copy Widget Code is a last resort—only necessary if you made a major color overhaul and wish to eliminate the first-paint transition on slow cellular networks.
1) Wait one minute and reload the page; 2) Check if Publish was clicked in Chat Studio; 3) Verify your exact domain is listed in 'Websites that can show your chat'; 4) Check for CSP errors in DevTools Console; 5) Re-copy the widget snippet if first-paint is stale.