Your Viewers embed code is a small snippet of JavaScript that powers the lead capture widget on your website. This guide walks you through generating your code and installing it on popular website platforms.
Before You Begin
Important: Your embed code is unique to your account and configuration. Every time you make changes to your widget settings - such as enabling modules, adjusting display options, or updating branding - you’ll need to copy your new embed code and reinstall it on your website.
Step 1: Generate Your Embed Code
- Log in to your Viewers dashboard
- Navigate to Settings → Embed Code (or click “Get Embed Code” from your dashboard)
- Configure your widget options:
- Select which modules to enable (we recommend keeping as many active as possible to maximize conversions)
- Adjust your display settings
- Configure any module-specific options
- Click Copy to copy your embed code to your clipboard
Your embed code will look something like this:
html
<script src="https://app.viewers.com/widget/YOUR-UNIQUE-ID.js" async></script>Step 2: Install on Your Website
Your embed code should be placed in the footer of your website, just before the closing </body> tag. This ensures your widget loads without slowing down your page content.
Choose your platform below for specific instructions:
WordPress
- In your Viewers.com dashboard, choose WordPress as the installation method. Download the Viewers.com Embed plugin, upload to your site, and install it.
- In WordPress, go to Settings → Viewers.com Embed
- Paste your API key into your plugin.
- Click Save. Done! All changes are now automatically synced in real time.
Shopify
- From your Shopify admin, go to Online Store → Themes
- Click Actions → Edit Code on your current theme
- Under the Layout folder, click on
theme.liquid - Scroll to the bottom and find the
</body>tag - Paste your Viewers embed code on a new line directly above
</body> - Click Save
Wix
- Go to your Wix dashboard and open your site in the Editor
- Click Settings in the left menu
- Select Custom Code under the Advanced section
- Click + Add Custom Code
- Paste your Viewers embed code
- Name it “Viewers Widget”
- Under Add Code to Pages, select “All pages”
- Under Place Code in, select Body – end
- Click Apply
Squarespace
- Go to Settings → Advanced → Code Injection
- Scroll down to the Footer section
- Paste your Viewers embed code
- Click Save
Webflow
- Open your project in the Webflow Designer
- Click the Settings icon (gear) in the left panel
- Go to the Custom Code tab
- Paste your Viewers embed code in the Footer Code section
- Click Save Changes
- Publish your site for the changes to go live
HubSpot
- Go to Settings → Website → Pages
- Click on Templates in the left sidebar
- Select Site Footer HTML
- Paste your Viewers embed code
- Click Save
Google Tag Manager
- Log in to your Google Tag Manager account
- Click Tags → New
- Name the tag “Viewers Widget”
- Click Tag Configuration → Custom HTML
- Paste your Viewers embed code
- Click Triggering and select All Pages
- Click Save, then Submit and Publish your container
Custom HTML / Other Platforms
For any website where you have access to the HTML:
- Open your website’s main template or layout file
- Locate the closing
</body>tag - Paste your Viewers embed code on a new line directly above
</body> - Save and upload your file
<!-- Your page content above -->
<!-- Viewers Widget -->
<script src="https://app.viewers.com/widget/YOUR-UNIQUE-ID.js" defer></script>
</body>
</html>Verifying Your Installation
After installing your embed code:
- Visit your website in a new browser window (or incognito/private mode)
- Look for the Viewers widget to appear in the corner of your screen
- Test the widget by interacting with it
- Check your Viewers dashboard to confirm leads are being captured
Troubleshooting
Widget not appearing?
- Clear your cache: Both your browser cache and any site caching plugins
- Check for conflicts: Temporarily disable other plugins to identify conflicts
- Verify placement: Ensure the code is inside the
<body>tags, not the<head> - Wait a few minutes: Some platforms take time to propagate changes
Widget looks different than expected?
Remember: changes to your widget configuration require reinstalling your embed code. If you’ve updated settings in your Viewers dashboard, copy the new embed code and replace the old one on your website.
Updating Your Embed Code
Whenever you modify your widget settings in the Viewers dashboard, follow these steps:
- Generate your new embed code from Settings → Embed Code
- Copy the updated code
- Remove the old embed code from your website
- Paste the new embed code in its place
- Save and clear any caches
Need Help?
If you’re having trouble installing your embed code, our support team is here to help. Contact us or use the chat widget in your dashboard.