> ## Documentation Index
> Fetch the complete documentation index at: https://docs.webless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Webless tag

> Install the hosted Webless experience in your shared layout and verify it across your site.

## Standard install

<Steps>
  <Step title="Collect your provisioning details" icon="key">
    Before you start, make sure you have:

    * Access to your site's shared HTML template or layout file
    * Your Webless script URL (please make sure to use published version)

    ```html theme={null}
    <script defer src="YOUR_SCRIPT_URL"></script>
    ```
  </Step>

  <Step title="Add the Webless script" icon="file-code">
    Add the hosted script at the start of `<body>` tag.

    ```html layout.html theme={null}
    <body>

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

      <!-- Your website content -->

    </body>
    ```
  </Step>

  <Step title="Deploy the changes" icon="rocket">
    After you add the script:

    1. Save your template files.
    2. Deploy your website changes.
    3. Open a page on your website.
  </Step>

  <Step title="Verify installation" icon="badge-check">
    Open your browser developer tools and confirm:

    * The Webless script loads successfully
    * No JavaScript errors appear in the console
    * Webless content renders inside the container
  </Step>
</Steps>

## Complete example

```html theme={null}
<!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>

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

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

  </body>
</html>
```

## Exclude specific pages

Remove the script from any template where Webless should not
render.

```html Pages without Webless theme={null}
<body>
  <!-- Normal page content only -->
</body>
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="Webless content does not appear" icon="search-x">
    Check the basics first.

    * Verify that the script URL is correct.
    * Verify that the script tag is placed at the start of `</body>`.
    * Verify that your domain has been authorized by Webless.
  </Accordion>
</AccordionGroup>

## Best practices

* Load the script at the start of the body for faster rendering.
* Use HTTPS for every hosted asset.
* Re-test after major website releases or template changes.

## Need help?

If you run into issues, contact the Webless team with:

* Your website URL
* The script URL you deployed
* A screenshot of any console errors
* Edit access to your website, if you can provide it
