LiftSell Installation Guide

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

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.

When the script tag loads, the following happens:

SDK Loading: The LiftSell JavaScript SDK is loaded asynchronously.
Widget Configuration: The SDK fetches your widget's configuration from the API.
DOM Render: The widget is automatically rendered to the bottom right corner of the page.
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.

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

1
Go to "Sites" tab
Go to the Sites page from the Dashboard.
2
Add domain
Click the "Add New Site" button and enter your domain (e.g.: example.com).
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
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.

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.

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.