Skip to main content
Use the exact script URL and tag ID that Webless gives you. Do not swap hosts, environments, or IDs manually.

​
Standard install

Collect your provisioning details

Before you start, make sure you have:
  • Access to your site’s shared HTML template or layout file
  • Your Webless script URL
  • Your Webless tag ID

Add the Webless container

Add the container immediately after the opening <body> tag in your global template.
layout.html
<body>
  <div id="YOUR_TAG_ID"></div>

  <!-- Your existing site content -->
</body>
The container must exist before the Webless script runs.

Load the Webless script

Add the hosted script right before the closing </body> tag.
layout.html
<body>
  <div id="YOUR_TAG_ID"></div>

  <!-- Your existing site content -->

  <script src="YOUR_SCRIPT_URL"></script>
</body>

Deploy and verify

After deployment, open a page on your site and confirm:
  • The script loads successfully in the network panel
  • The container element exists in the DOM
  • No JavaScript errors appear in the console
  • Webless content renders inside the container

​
Complete example

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Your website</title>
  </head>
  <body>
    <div id="wb-homepage-tag"></div>

    <header>...</header>
    <main>...</main>
    <footer>...</footer>

    <script src="https://store.webless.ai/YOUR_COMPANY/tags/prod/YOUR_COMPANY.js"></script>
  </body>
</html>

​
Common questions

Check the basics first.
  • Verify that the script URL is correct.
  • Verify that the script tag is placed before </body>.
  • Verify that your domain has been authorized by Webless.
  • Verify that the container ID matches the provisioned tag ID exactly.
This usually means the script ran before the target element existed.
  • Make sure the container appears before the script tag.
  • Make sure the ID in your HTML exactly matches the ID expected by the script.
  • Make sure the script is installed in the shared template, not only on a partial or nested page.
Remove the container and script from any template where Webless should not render.
Pages with Webless
<body>
  <div id="YOUR_TAG_ID"></div>
  <script src="YOUR_SCRIPT_URL"></script>
</body>
Pages without Webless
<body>
  <!-- Normal page content only -->
</body>
Keep the install simple and consistent.
  • Load the script at the end of the body for faster page rendering.
  • Keep the install in your global layout so behavior stays consistent.
  • Use HTTPS for every hosted asset.
  • Re-test after major website releases or template changes.
If you want the search trigger to live in different desktop and mobile positions, follow Add Webless to your navbar instead of the single-container pattern.