Script Integration: The Complete 2026 Guide
How to Add iClarus to Your Website
Adding tooltips and onboarding tours to your website takes just one line of code. Here's how to do it on any platform in under 5 minutes.
The General Approach
To enable iClarus tooltips, you need to add a single script tag to the <head> section of your HTML.
Step 1: Get your Project ID from your iClarus dashboard (Integration section)
Step 2: Copy this script from your Dashboard:
<script src="https://sdk-seven.vercel.app/sdk.js?id=YOUR_PROJECT_ID"></script>
Step 3: Add it to your website's <head> section, just before the closing </head> tag.
That's it! Your tooltips will now appear automatically.
Platform-Specific Instructions
WordPress
- Go to Appearance → Theme File Editor
- Click on header.php in the right sidebar
- Find the
</head>tag (usually near line 20-30) - Paste the script just above
</head> - Click Update File
Alternative (easier): Install a plugin like "Insert Headers and Footers" and paste the script in the header section.
Shopify
- Go to Online Store → Themes
- Click Actions → Edit code
- Open theme.liquid from the left sidebar
- Find the
</head>tag (press Ctrl+F to search) - Paste the script just above
</head> - Click Save
Wix
- Go to Settings (in the dashboard menu)
- Click Custom Code under Advanced
- Click + Add Custom Code
- Paste your script
- Name it "iClarus Tooltips"
- Choose Head as the placement
- Select All Pages
- Click Apply
Squarespace
- Go to Settings → Advanced → Code Injection
- Find the Header section
- Paste the script in the Header box
- Click Save
The script will now load on all pages.
Webflow
- Go to your Project Settings (gear icon)
- Click the Custom Code tab
- Scroll to Head Code
- Paste the script
- Click Save Changes
- Publish your site
Framer
- Click the Settings icon (gear) in the top right
- Go to General → Custom Code
- Find the Start of
<head>tag section - Paste the script
- Changes save automatically
- Publish your site
Next.js / React
Add the script to your layout or _document.js:
In Next.js App Router (app/layout.tsx):
export default function RootLayout({ children }) {
return (
<html>
<head>
<script src="https://sdk-seven.vercel.app/sdk.js?id=YOUR_PROJECT_ID" async />
</head>
<body>{children}</body>
</html>
)
}
In Next.js Pages Router (pages/_document.js):
import { Html, Head, Main, NextScript } from 'next/document'
export default function Document() {
return (
<Html>
<Head>
<script src="https://sdk-seven.vercel.app/sdk.js?id=YOUR_PROJECT_ID" async />
</Head>
<body>
<Main />
<NextScript />
</body>
</Html>
)
}
HTML / Custom Sites
If you're working with plain HTML files:
- Open your HTML file in any text editor
- Find the
<head>section - Add the script before
</head> - Save the file
- Upload to your server
Example:
<!DOCTYPE html>
<html>
<head>
<title>My Website</title>
<!-- Your other tags -->
<script src="https://sdk-seven.vercel.app/sdk.js?id=YOUR_PROJECT_ID"></script>
</head>
<body>
<!-- Your content -->
</body>
</html>
Google Tag Manager
- Go to Tags → New
- Click Tag Configuration
- Choose Custom HTML
- Paste your script
- Click Triggering and select All Pages
- Name it "iClarus SDK"
- Save and Submit your container
Verification
After adding the script, visit your website and:
- Right-click anywhere on the page
- Click View Page Source (or Inspect)
- Press Ctrl+F and search for "sdk-seven.vercel.app"
- If you see your script, it's installed correctly!
You can also check your browser's Console (F12 → Console tab) - there should be no errors related to iClarus.
Troubleshooting
Tooltips not appearing?
- Make sure you've created tooltips in your dashboard
- Check that your Project ID is correct
- Clear your browser cache and refresh
- Verify the script is in the
<head>section, not<body>
Still having issues? Contact support with your website URL and we'll help you get set up in minutes.
That's it! Your website now has contextual tooltips. Create and manage them from your iClarus dashboard - no code changes needed.