Deploying your VWAM agent makes it live and accessible to users. VWAM supports two deployment options:
On-page (embedded): Add a script and container to your website.
Owned web: Use a VWAM-hosted standalone URL.
Choose the option that aligns with your technical setup, user experience goals, and launch timeline.
Before you begin
Before deploying your agent:
Confirm your agent configuration is complete.
Decide whether you want to:
Embed the agent directly into your website (on-page), or
Launch quickly using a hosted URL (owned web).
Ensure you have:
Website or CMS access for on-page deployment, or
The shareable link for owned web deployment.
Deploy your agent
Option 1: Deploy on-page (embedded)
Use on-page deployment to embed the agent directly into your website and keep users within your domain. This option works well for product pages, landing pages, and dedicated AI sections.
On-page deployment requires:
A global script
A container placed where the agent should appear
Complete both steps to make your agent live.
Step 1: Install the Script (Global)
On-page deployment requires adding both a script and a container to your site.
HTML
<script src="https://chat.vwam.ai/vwam.min.js" async></script>
This script:
Loads the VWAM engine
Connects to your agent
Needs to be added once per site
Best practice: Place the script inside your site’s <head> tag so it loads across all pages.
Step 2: Add the agent container (placement)
Add the container code where you want the agent to appear:
HTML
<div class="vwam-chat-XXXXXXX" data-vwam-config="XXXXXXX" width="100%" height="600px"></div>
The container:
Determines where the agent renders
Links to your specific agent configuration
Controls width and height
You can place the container:
Inline within page content
On a dedicated “Shop with AI” page
Within a landing page section
Inside a modal
Anywhere custom HTML is supported
Once both the script and container are added and published on your site, your agent is live.
Example implementations
View exampled embed configurations here.
Option 2: Owned Web Deployment (Hosted)
Use owned web deployment for quick launches, testing, campaign traffic, or no-code setup. Owned Web requires no installation. No script, code changes, or CMS access required.
With owned web:
VWAM hosts a full-page chat experience.
You receive a unique, shareable URL.
No website installation is required.
You can:
Link to the page from your homepage
Use it in marketing campaigns
Share internally for testing
Send it directly to customers
Shopify deployments
Add a Custom Liquid section for both the script and container.
Paste both the global script and the container code.
Update the container code to include
display: block;:
HTML
<div
class="vwam-chat-XXXXXXX"
data-vwam-config="XXXXXXX"
style="width:100%; height:600px;display: block;"
></div>
Next steps
Test your live deployment in production.
Confirm styling, responsiveness, and placement.
Share the owned web URL or embed location with internal stakeholders.
Monitor usage and engagement.
FAQ
What’s the difference between On-Page and Owned Web?
On-Page embeds the agent directly into your website using a script and container. Owned Web provides a standalone VWAM-hosted URL with a full-page chat experience.
Do I need developer access?
For Owned Web: No. For On-Page: You need access to your site’s code or a CMS area that allows custom HTML.