Get Started

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:

Table of contents

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.

Related Posts: