Owners: embed the widget and customize the consent prompt

Advanced guide to install the Omnifox widget on your site and tailor the consent prompt customers see before sharing their screen.

Jun 26, 2026

Watch this step in the video · If the customer says no

Co-browse runs inside the Omnifox web chat widget: the customer shares their screen from the same window where they chat, always with explicit consent. This advanced guide is for owners and admins who install the widget and want to understand how that consent is requested.

Requirements

  • Admin role in the workspace.
  • The Co-browsing add-on active on the organization.
  • Access to edit your site's HTML (or your tag manager).

1. Get and embed the widget code

  1. Open Settings → Channels and select your Webchat channel.
  2. Open Customize Widget to set colors, language, and branding.
  3. Copy the Embed Code shown in the panel.
  4. Paste it right before the </body> tag on every page where you want chat.
  5. Publish your site and reload — the floating widget button should appear.

The same snippet enables both chat and Co-browse. You don't need a second script: co-browsing is lazy-loaded when the agent requests it.

2. Verify the installation

  • In the Webchat channel panel check Detected installations — it should register your domain.
  • Open your site in an incognito tab and confirm the widget loads with no console errors.

3. How consent is requested

When an agent starts Co-browse, the customer sees a prompt to Accept or Decline screen sharing. This prompt is built-in and automatic — there is nothing to write or configure from the panel. What matters to know:

  1. The text is fixed and ships translated into Spanish, English, and Portuguese. The language is picked automatically from the session locale or your <html> lang attribute; declare <html lang="en"> (or es / pt) so it shows in the right language.
  2. Consent is requested for every session — never "once and for all." Each time an agent requests Co-browse, the customer decides again.
  3. The prompt already tells the customer that passwords and card data are masked automatically and that they can stop sharing at any time.

The agent only sees the screen while the customer keeps the session open; closing it ends access immediately.

If it doesn't work

  • The widget doesn't appear: confirm the snippet is before </body> and that your CDN/cache has purged the old version.
  • No Co-browse button: check the add-on is active and the agent has the "Can start co-browse sessions" permission.
  • The customer doesn't see the consent prompt: usually widget cache — force a hard reload or re-publish.

Tips

  • Keep the consent text clear and short — it raises the acceptance rate.
  • If you use a tag manager, load the snippet on every template, not just the home page.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp