How to Manually Install the Oscar Chat Widget Code on Your Website

The Oscar Chat widget must be installed in your website footer, directly before the closing </body> tag. This ensures proper loading, better performance, and consistent behavior across all pages.

If you prefer to install via Google Tag Manager instead of editing site code, follow this guide: How to add Oscar Chat using Google Tag Manager.

Written by:

Matt Maloney, Prutha Parikh

In Publication:

ON February 17 2026

Setup Guides
AI Chatbots for Real Estate:

Why install Oscar Chat in the footer?

Installing in the footer ensures:

  • The page content loads first
  • The widget initializes after the DOM is ready
  • No render-blocking in the header
  • Clean, global installation across all pages

Step-by-step Manual Installation

Step 1: Copy your install script from Oscar Chat

In your Oscar Chat workspace, locate your installation script. It will look like this:

<script>
  window.OscarChatConfig = {
    "userHash": "Your Hash",
    "workspace": 'Your Number"
  };
</script>
<script src="https://app.oscarchat.ai/script/oscar-widget-loader.min.js"></script>

Your userHash and workspace ID will be unique to your account.

Step 2: Open your global website template

Locate the main layout file that loads on every page:

  • WordPress: footer.php
  • Shopify: layout/theme.liquid
  • Webflow: Project Settings → Custom Code → Footer
  • Custom HTML: Main template before closing body tag

Step 3: Paste the script before </body>

Insert the entire script block directly above the closing </body> tag.

Example structure:

...
<!-- Your website content -->

<script>
  window.OscarChatConfig = {
    "userHash": "YOUR_USER_HASH",
    "workspace": YOUR_WORKSPACE_ID
  };
</script>
<script src="https://app.oscarchat.ai/script/oscar-widget-loader.min.js"></script>

</body>

Step 4: Save and publish

  1. Save your changes
  2. Deploy or publish your website
  3. Open your site in incognito mode to confirm the widget loads

Important: Install in only one place

Do not install Oscar Chat both manually and via Google Tag Manager. This will cause duplicate widgets.

If switching to GTM, remove the footer installation first, then follow: Google Tag Manager installation guide.

Verification Checklist

  • The widget appears on every page
  • No console JavaScript errors
  • The widget loads once

FAQ

Do I need technical skills to install Oscar Chat manually?

No advanced development skills are required. If you have access to your website’s footer or global template and can paste a script before the closing </body> tag, you can install Oscar Chat in minutes.

Will the widget load on all pages automatically?

Yes. If you install the script inside your global footer template, Oscar Chat will appear across your entire website without additional configuration.

Is Google Tag Manager better than manual installation?

Manual installation is the simplest method. Google Tag Manager is useful if your team prefers centralized script management. You can follow the GTM guide here: Google Tag Manager installation guide.

Can I remove Oscar Chat at any time?

Yes. You can stop any of your widgets directly from your Oscar Chat dashboard at any time. You can also remove the installation script from your website footer if you want to fully disable the widget.

Frequently Asked Questions

What is the main benefit of live chat?

Live chat helps visitors get quick answers at the moment they are deciding whether to buy, book, sign up, or contact the business.

When should a website use AI instead of live chat?

Use AI for repeat questions, offline hours, and quick first replies. Use human live chat for complex issues, pricing, complaints, and high-intent conversations.

What makes a chat widget convert better?

A good chat widget is visible, fast, mobile-friendly, easy to close, and matched to the visitor intent on each page.

Should live chat collect contact details?

Yes, but only at the right time. Ask for email or phone when follow-up is needed, not before the visitor receives any value.

What metrics should teams track?

Track chat starts, response time, AI resolution, handoff rate, missed chats, qualified leads, and conversion after chat.

How does Oscar Chat help?

Oscar Chat combines live chat, AI chatbot answers, forms, popups, and lead capture so teams can support visitors without managing separate tools.