Builder — Publish & Deploy

Your edits in the builder save to a draft. This article explains how to publish that draft to your live agent, and how to put the agent on your site.

Prerequisites

Your agent needs rules, product settings, and design settings. If any of those sections is empty, the agent does not publish.

Publish your agent

1. Open the agent in the builder.
2. Click Publish at the top right. A panel opens.
3. Read the text at the bottom left of the panel. It reads Not published yet, or it names the date of the last publish, for example Published 3 days ago.
4. Click Publish at the bottom right of the panel.
5. Wait for the message Published — you're live.

Your live agent now serves the version that you published.

Screenshotthe builder header with the Publish panel open, showing the launch-type pills and the footer Publish button

Choose where the agent runs

The top of the Publish panel holds one pill for each active launch type. Each pill carries its own install instructions.

Launch type	Where the agent runs
On-page	Inside a container on your own web page.
Owned web	On a full-page link that VWAM hosts for you.
Sitewide widget	A corner launcher on your site that opens the assistant. This option appears when it is enabled for your account. Verifyconfirm Sitewide widget pilot exposure before publication
Product Q&A	As a question-and-answer block on a product page.

Warning: a change to the launch types publishes your agent immediately. All of your unpublished edits go live at that moment. Publish or discard your draft edits before you change a launch type.

To add a launch type, click the + button next to the pills. Then pick a type from the menu. To remove a launch type, click the X on its pill. At least one launch type must stay active.

Product Q&A is available only to accounts that have the feature turned on. It requires its own agent. On-page, Owned web, and Sitewide widget can share an agent when those options are available to your account. To run Product Q&A alongside them, create a second agent.

Install the On-page agent

1. Select the On-page pill.
2. Under Add Global Script, click Copy Script.
3. Paste the script into your site template, or into your tag manager. One script serves all of your agents.
4. Under Place Agent Container, click Copy Container.
5. Paste the container into the page, at the exact spot where the chat belongs.

Your script names your organization

The global script tag carries a data-vwam-org attribute that names your organization:

<script src="https://chat.vwam.ai/vwam.min.js" data-vwam-org="your-organization-id" async></script>

Copy the script from the Publish panel, or from Settings → Deployment, and it already carries the attribute. You never fill it in by hand.

If your site still runs an older snippet that has no data-vwam-org, your agent keeps working exactly as before, and you see no error. But page views are not captured, so no agent can personalize on what a shopper browsed. Recopy the script and replace the tag on your site. See Listeners for what that capture is used for.

Share the Owned web agent

1. Select the Owned web pill.
2. Under Copy & Share Your Link, click Copy Link.
3. Send the link to shoppers, or link to it from your site.

Set the browser tab icon

The Owned web link opens the agent as a full page, and the browser tab shows an icon next to the page title. You can upload a separate icon for that tab, called a favicon. This helps when your logo does not show up well in a browser tab, for example a white logo on a white tab.

1. In the builder, open Content, then find Media.
2. Next to Favicon, directly under Logo, upload an image or choose one from your asset library. You can use an SVG, PNG, or JPEG file of up to 512KB.
3. Publish the agent. Shoppers see the new icon only after you publish.

Screenshotthe Content > Media section with the Favicon row under Logo and its info tooltip open

The favicon is optional. Without one, the tab shows your chat logo. Without a logo, the tab shows a default icon.

The favicon applies only to full page deployments, as the info tooltip next to Favicon says. The On-page, Sitewide widget, and Product Q&A launch types never change the icon in your own site's browser tab. The favicon has no opacity or fit settings.

Install the Product Q&A block

Select the Product Q&A pill. The panel offers three install methods. Read Product Q&A Install for the full steps.

Install the Sitewide widget

Verifyconfirm Sitewide widget pilot exposure before publication

1. Add Sitewide widget with the + button, then select its pill.
2. Copy the widget script shown in the panel.
3. Paste it into your site template or tag manager on each page where you want the launcher.
4. Publish the agent, then test opening it and moving between pages on your site.

The widget script needs no page container. Avoid installing an On-page container for the same agent on the same page: whichever installation loads first stays active.

Use Design > Visuals > Widget Launcher to set its color, avatar, corner, spacing, teaser, and unread indicator. These settings belong to the sitewide launcher; they do not change Product Q&A. Leaving the teaser empty hides it. Showing a teaser does not start a chat.

When consent permits saving, a shopper can move between pages on the same site and keep completed answers and an unsent draft. An interrupted answer offers Ask again; it does not send automatically. Different site origins do not share the conversation. Tabs share completed history but keep separate drafts and panel state.

To close the widget, click X in its title bar. On mobile, opening the launcher focuses this button. An automatically restored panel preserves the shopper's existing page focus until they interact with the panel, so restoration does not open the keyboard.

To retire the widget, remove its launch type and publish a remaining type, then remove its script from your site. Account availability changes alone leave a published installation in place.

Publish first, then test

You can copy the script, the container, and the link before your first publish. None of them works until you publish the agent. Publish first, then test the code on your site.

Change your agent after you deploy

Your installed code carries no version. Every publish replaces the live version behind the same code. You never paste the code again.

To see a draft before you publish it, click the eye icon at the top of the builder. The preview opens the draft version. Your live agent does not change.

Roll back a published version

1. Open the agent in the builder.
2. Click the Version History icon in the left rail.
3. Find the version that you want.
4. Click Rollback.
5. Confirm the rollback in the dialog.

A rollback returns your agent to the Draft state. Publish again to make that version live.

To drop your unpublished edits and keep the live version, click Discard Changes on the live row.

A rollback or a discard also clears your design undo history. To step back through single design edits without rolling back, use Undo in the toolbar above the preview instead. Undo changes your draft only; see Undo and redo design changes.

Find the install code later

1. Open Settings.
2. Click Deployment.

The page lists installation code for each published agent. Sitewide widget agents show Copy Widget Script when that option is available. Unpublished agents do not appear there.