Skip to main content

Embedding Karo

Karo embeds on your website as a single line of code. Once added, it loads a chat widget in the bottom corner of the page.

Getting your embed code​

Go to Dashboard in the Karo sidebar. Your embed code is displayed there. It looks something like this:

<script src="https://app.heykaro.com/embed.js?app=your-app-id" async></script>

This is your unique embed script. Don't share it publicly — the app parameter identifies your Karo app.

Adding the code to your website​

There are two main ways to add the embed code.

Google Tag Manager is the most flexible approach, and the one we recommend for most venues.

  1. Open your GTM workspace.
  2. Create a new tag of type Custom HTML.
  3. Paste the embed code into the HTML field.
  4. Set the trigger to All Pages (or whichever pages you want Karo to appear on).
  5. Save and publish.

GTM gives you control over which pages Karo appears on, and makes it easy to pause or update the embed without developer access.

Via your website's <head> tag​

If you have direct access to your website's code, paste the embed script inside the <head> tag of your HTML:

<head>
  <!-- Your existing head content -->
  <script src="https://app.heykaro.com/embed.js?app=your-app-id" async></script>
</head>

For WordPress sites, many themes have a custom head code field in Theme Settings. Alternatively, a plugin like Insert Headers and Footers works well.

If you're not comfortable editing your website's code, ask your web developer.

Testing the installation​

Once added, visit your website and look for the Karo launcher button in the bottom corner. Click it to open the widget and test a conversation.

If the widget doesn't appear, check:

  • The embed code is saved and published (if using GTM)
  • Your allowed domain is set correctly
  • There are no JavaScript errors in your browser console
tip

Use the demo link at https://dashboard.heykaro.com/demo/your-app-id to test before going live. This lets you see exactly how the widget behaves without embedding it on your site.

Cookies​

Karo uses first-party cookies only. These are scoped to your domain and are used to maintain the visitor's chat session. No third-party tracking cookies are set.