LiftSell Installation Guide

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

Table of Contents

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

`

Note: Replace ls_xxxwith 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 asyncattribute 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

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