Once your website domain is authorized in JIVIQ (as described in Step 2: Add Your Website Domain), your workspace is ready to generate its production embed code.

In the official JIVIQ application (app.jiviq.com), the widget installation code is located inside Chat Studio → Install.

navigation

Navigation Path:

JIVIQ App → Select Workspace → Chat Studio (Left Sidebar) → Install (Top Tab) → Website Code.

JIVIQ Chat Widget Installation Dashboard

image The Chat Studio Install center showing the Website Code snippet and allowed domains area.

Code Structure

2. Understanding the Generic Widget Script

The JIVIQ widget is loaded through a clean, single HTML <script> element:

Generic Embed Code Blueprint

<script
  src="https://widget.jiviq.com/v1.js"
  data-tenant="your-business"
  data-capability="your-workspace-id"
  data-launcher-color="#000666"
  data-position="bottom-right"
  data-icon="chat"
  async defer>
</script>

warning

error_outline Important Warning

Important Account Rule:

The generic placeholder values (your-business and your-workspace-id) shown above will NOT connect to your assistant. You must copy the exact script generated inside YOUR own JIVIQ account dashboard.

API Reference

3. Script Attributes & Parameters Breakdown

Every attribute in the JIVIQ script tag serves a specific function in initializing, styling, and optimizing the chat experience:

Attribute	Example Value	Type	Function & Description
`src`	`https://widget.jiviq.com/v1.js`	Required	Points to JIVIQ's global edge CDN loader file. Never modify this URL.
`data-tenant`	`your-business-slug`	Required	Unique account identifier ensuring tenant isolation and database separation.
`data-capability`	`tenant.workspace-id`	Required	Identifies your specific AI brain, skills, knowledge base, and prompt persona.
`data-launcher-color`	`#000666`	Optional	The background color of the floating chat bubble in hex or RGB format.
`data-position`	`bottom-right`	Optional	Controls screen anchor point: `bottom-right` or `bottom-left`.
`data-icon`	`chat`	Optional	Sets the launcher glyph: `chat`, `support`, or `sparkle`.
`async defer`	Boolean flags	Performance	Ensures non-blocking background script loading for lightning-fast page speed.

Step-by-Step

4. Step-by-Step: Copying Your Unique Code

Follow these straightforward steps to copy your unique snippet:

Verify Your Active Workspace

Ensure the workspace dropdown in the top-left corner reflects the intended business unit or website project.

Open Chat Studio → Install

Click Chat Studio in the main navigation menu, then click the Install tab at the top of the screen.

Confirm Allowed Website Status

Verify that your bare domain (e.g., yourdomain.com) is listed with an Active green status badge.

Click "Copy Code"

Click the Copy Code button located above the snippet box. A toast notification will confirm that the code is safely copied to your clipboard.

JIVIQ Widget Installation Code Copying Dashboard

image Copying the unique workspace JavaScript snippet ready for HTML embedding.

Account Security

5. Important: Copy Your Own Account Code

In our live test case on Nexora AI (https://jamesdavis.github.io/nexora-ai/), the test installation used:

Nexora AI Demo Key (Reference Only)

<!-- DO NOT COPY THIS ACCOUNT-SPECIFIC CODE FOR YOUR SITE -->
<script
  src="https://widget.jiviq.com/v1.js"
  data-tenant="nexora-ai"
  data-capability="nexora-ai.nexora-ai"
  data-launcher-color="#000666"
  data-position="bottom-right"
  data-icon="chat"
  async defer>
</script>

The values data-tenant="nexora-ai" and data-capability="nexora-ai.nexora-ai" belong strictly to the Nexora AI demonstration account. If copied to your website, visitors would converse with the Nexora demo rather than your company's AI. Always generate and copy your own unique credentials from JIVIQ.

Interface Mockups

6. Visual Interface Walkthrough

Review these screenshots showing how the installation and code copying workflow appears in JIVIQ:

app.jiviq.com/chat-studio/install

image Image 1 • JIVIQ Chat Studio showing the Website Code snippet area.

app.jiviq.com/chat-studio/install

image Image 2 • One-click copy button confirming snippet copied to clipboard.

Knowledge Base

7. Frequently Asked Questions

Common inquiries about script generation, asynchronous loading, and workspace capabilities:

Where do I find my JIVIQ widget embed code? add

Sign in to app.jiviq.com, select your target Workspace, click 'Chat Studio' in the sidebar navigation, and select the 'Install' tab. Your generated code is located in the 'Website Code' section.

Why is each JIVIQ widget code unique to each workspace? add

The widget snippet contains unique 'data-tenant' and 'data-capability' parameters. These cryptographic keys route visitor messages to your specific AI knowledge base, business rules, and team inbox.

Can I copy the code snippet from another website or tutorial? add

No. Never copy widget code from another company or sample site like Nexora AI. Doing so would connect your website visitors to someone else's workspace. Always copy your own snippet from your JIVIQ dashboard.

What does the 'data-tenant' parameter do? add

The 'data-tenant' attribute identifies your root organization or company account within JIVIQ's multi-tenant architecture, ensuring strict data isolation.

What does the 'data-capability' parameter do? add

The 'data-capability' attribute specifies the exact AI assistant and skill pipeline assigned to this widget, directing visitor queries to the correct responder model.

Can I customize the widget color and corner position in the code? add

Yes. You can adjust 'data-launcher-color' (e.g., #000666 or your brand hex) and 'data-position' ('bottom-right' or 'bottom-left') directly within the script or inside the JIVIQ Chat Studio visual customizer.

Why does the JIVIQ script include 'async' and 'defer' attributes? add

Both 'async' and 'defer' ensure that the widget script loads non-blockingly in the background. Your page HTML, styling, and hero content render at maximum speed without waiting for the widget.

How large is the JIVIQ widget script file? add

The JIVIQ core bootstrap loader is ultralight (~4KB compressed) and served through a global Content Delivery Network (CDN) with sub-30ms latency.

Does the widget affect my Google Core Web Vitals or PageSpeed score? add

No. Because of asynchronous CDN delivery and deferred execution, JIVIQ maintains a neutral impact on Largest Contentful Paint (LCP) and First Input Delay (FID).

If I have multiple Workspaces, does each have its own code? add

Yes. Each Workspace generates a distinct capability key. If you manage multiple brands or client sites, make sure you select the correct workspace from the top switcher before copying your code.

What happens if I regenerate or change my workspace keys? add

If you change workspace configurations or transfer ownership, you can copy the updated snippet from Chat Studio and update the script tag on your website.

Can I embed two different JIVIQ widgets on the same page? add

No. A single webpage should only contain one JIVIQ script tag to prevent launcher collision and session state conflicts.

Why is the 'Copy Code' button disabled or missing? add

Ensure you have completed Step 2 (adding at least one authorized domain). JIVIQ requires domain registration before generating active production snippets.

I copied the code but some characters look escaped in my HTML editor. Is that normal? add

Some CMS rich-text editors convert quotes into HTML entities (like "). Ensure you paste the snippet into a raw HTML block or Code Embed field, not a rich text visual editor.

Where can I view the full technical widget API documentation? add

Visit our developer docs at https://jiviq.com/help/website-installation/install-jiviq-on-your-website or explore custom event hooks at https://jiviq.com/help/chat-customization/customize-chat-panel.