# LiftSell Installation Guide

Step-by-step guide to integrate your widget into your site

## Table of Contents

- [1\. General Script Installation](/content/docs/install#general-install/index.html)
- [2\. What the Script Tag Does](/content/docs/install#script-explanation/index.html)
- [3\. Domain Verification](/content/docs/install#domain-verification/index.html)
- [4\. Testing](/content/docs/install#testing/index.html)

## 1\. General Script Installation

To add your widget to your site, add the following script tag before the `<head>`or `</body>`tag in your HTML:

`<script
src="https://www.liftsell.com/embed/ls_xxx"
async
></script>`

**Note:** Replace `ls_xxx`with your widget's actual public key. You can copy the public key from the widget editor page or embed modal.

## 2\. What the Script Tag Does

When the script tag loads, the following happens:

1. **SDK Loading:** The LiftSell JavaScript SDK is loaded asynchronously.
2. **Widget Configuration:** The SDK fetches your widget's configuration from the API.
3. **DOM Render:** The widget is automatically rendered to the bottom right corner of the page.
4. **View Tracking:** Each widget view is automatically recorded.

**Important:** Don't forget to add the `async`attribute to the script tag. This allows the widget to load without blocking page loading.

## 3\. Domain Verification

To make your widget work only on verified domains, you need to verify your domain:

1. 1
   
   Go to "Sites" tab

2. 2
   
   Add domain
   
   Click the "Add New Site" button and enter your domain (e.g.:`example.com`).

3. 3
   
   Add meta tag snippet
   
   Add the meta tag snippet provided to you in your site's`<head>` section:
   
   `<meta name="liftsell-site-verification" content="site_xxxxxxxxxxxx" />`

4. 4
   
   Click Verify button
   
   Click the "Verify" button next to your domain on the Sites page. The system checks for the presence of the meta tag.

**Success:** After the domain is verified, your widget will start working on this domain.

[→ Detailed domain verification guide](/content/docs/domain-verification/index.html)

## 4\. Testing

### Console Check

Open browser developer tools (F12) and go to the Console tab. There should be no errors when the widget loads.

`// Expected: No errors
// If you see errors, make sure the public key is correct.`

### View Limit / Domain Error

If the widget doesn't appear, the following situations may occur:

- **View limit exceeded:** Your monthly view limit may be full. The widget will not load silently (silent fail).
- **Domain not verified:** If your domain is not verified, the widget will not work.
- **Invalid public key:** The public key in the script may be incorrect.

**Note:** In case of view limit or domain error, the widget will not load silently. You may see a warning message in the console.

[→ Learn more about view limits](/content/docs/usage-limits/index.html)