Installing Pathmonk on your website

Installing Pathmonk on your website is the first step to start collecting behavioral data and activating AI-powered personalization. 

The Pathmonk SDK snippet must be installed for Pathmonk to gather insights and display Micro-Experiences later on.Nothing will appear live on your site until you decide to publish your experiences, so installation won’t affect your current website.

Before you start

Make sure you have:

• Access to your website or tag management platform (e.g. Google Tag Manager, WordPress, Shopify, Webflow, Squarespace).

• Your Pathmonk SDK snippet, which you’ll find in your Pathmonk installation screen during the onboarding. You can always ask our team to send it to you by emailing support@pathmonk.com

Installation options

During the onboarding, after the first few questions, you will reach this screen. Here's where you'll find your Pathmonk SDK snippet along with information on how to install Pathmonk:

You can install Pathmonk in three different ways:

1. Via platform (recommended)
   The easiest option — choose your platform (Google Tag Manager, WordPress, Shopify, Webflow, or Squarespace), copy the snippet, and follow the steps below.

2. Manual installation
   Copy and paste the snippet directly into your website’s HTML code.

3. Email to developer
   If someone else manages your website, you can simply send them the snippet and these instructions.

1. Install using Google Tag Manager (recommended)

Google Tag Manager (GTM) is the cleanest and most flexible way to install Pathmonk. It allows you to manage all your website scripts in one place and update them easily later on.

Step-by-step:

1. Copy the Pathmonk SDK snippet from your Pathmonk setup screen or the setup email.
   It will look like this (your client ID will be unique):

   <!-- Loading Pathmonk web SDK for JavaScript -->
   <script async type="text/javascript">
   (function(d,key) {
       var js, si = 'pathmonk-js-sdk'; var dv, vi = 'pathmonk-root';
       if (d.getElementById(si)) return; if (d.getElementById(vi)) return;
       dv = d.createElement('div'); dv.id = vi;
       dv.style.cssText = "display:none";
       dv.setAttribute("setup", "page_plugin");
       dv.setAttribute("client_id", key);
       d.body.appendChild(dv);
       js = d.createElement('script'); js.id = si;
       js.src = 'https://pathmonk-lib.pathmonk.com/plugin/plugin.min.js';
       d.body.appendChild(js);
   }(document, "YOUR_CLIENT_KEY_HERE"));
   </script>
   

2. Log into your Google Tag Manager account.

3. Click Add a new tag.

4. Rename the tag to Pathmonk.

5. Under Tag Configuration, select Custom HTML.

6. Paste the Pathmonk snippet into the HTML field.

7. Under Triggering, choose All Pages (this ensures Pathmonk loads across your entire website).

   • Optionally, you can add an Exception if you want to exclude specific subdomains or pages.

8. Click Save.

9. Back in the GTM dashboard, click Submit (top right), then Publish.

Done! Pathmonk will now load on your site.
There might be a short delay before your Pathmonk dashboard shows the connection as complete.

2. Install on Shopify

If your website runs on Shopify, you can install Pathmonk directly by adding a short code snippet to your theme, or via Google Tag Manager (see previous step).

The version of the snippet in this article includes revenue tracking by default, which allows Pathmonk to measure not only conversions but also the actual revenue generated by your store.

Note: The snippet you see inside your Pathmonk account may look slightly different — it doesn’t include the eshop="on" attribute at the moment. We recommend using the code below instead and simply replacing the client key with your own.

Copy the snippet below and replace YOUR_CLIENT_KEY_HERE with your actual client key from the Pathmonk setup screen or email.

<!-- Loading Pathmonk web SDK for JavaScript -->
<script async type="text/javascript">
(function(d,key) {
    var js, si = 'pathmonk-js-sdk'; var dv, vi = 'pathmonk-root';
    if (d.getElementById(si)) return; if (d.getElementById(vi)) return;
    dv = d.createElement('div'); dv.id = vi;
    dv.style.cssText = "display:none";
    dv.setAttribute("setup", "page_plugin");
    dv.setAttribute("eshop", "on");
    dv.setAttribute("client_id", key);
    d.body.appendChild(dv);
    js = d.createElement('script'); js.id = si;
    js.src = 'https://pathmonk-lib.pathmonk.com/plugin/plugin.min.js';
    d.body.appendChild(js);
}(document, "YOUR_CLIENT_KEY_HERE"));
</script>

Steps:

1. In Shopify Admin, go to Online Store > Themes.

2. Click Actions > Edit Code on your active theme.

3. Under Layout, open theme.liquid.

4. Paste the snippet right before the closing </body> tag.

5. Click Save and Publish.

Tip: If you already use Google Tag Manager on Shopify, follow the GTM instructions above instead — just make sure you use the e-commerce version of the code (eshop="on").

See: How to set up revenue tracking on Shopify

3. Install on WordPress

1. Copy your Pathmonk snippet.

2. In your WordPress Admin, go to Appearance > Customize.

3. Open the Footer section (or use a plugin like Insert Headers and Footers).

4. Paste the snippet right before the closing </body> tag.

5. Click Publish to save.

Once done, Pathmonk will start tracking visits automatically.

4. Install on Webflow

1. Copy your Pathmonk snippet.

2. In Webflow, go to Site settings > Custom code.

3. Paste the snippet in the Footer code section.

4. Click Save changes.

5. Republish your website to apply the changes.

5. Install on Squarespace

1. Copy your Pathmonk snippet.

2. In Squarespace, go to Settings > Advanced > Code Injection (or edit the footer area directly if you prefer).

3. Paste the snippet before the closing </body> tag.

4. Save and refresh your site.

6. Manual installation (for custom websites)

If your website is custom-built or doesn’t use any of the above platforms:

1. Copy your Pathmonk SDK snippet.

2. Paste it into your website’s HTML template — ideally just before the closing </body> tag.

   • This ensures Pathmonk loads on every page.

3. Save and publish your changes.

Once the snippet is installed, Pathmonk will automatically detect traffic and start collecting visitor data.

7. Verify your installation

After installation, your Pathmonk dashboard will show a status message like “Waiting for incoming connection.”

To confirm everything is working:

1. Open your website in a new browser tab.

2. Visit a few pages normally.

3. Return to the Pathmonk dashboard — it should update to show that your connection is active.

✅ Once connected, your setup is complete and Pathmonk is ready for the next steps in onboarding.

⚠️ Notes and troubleshooting

• It can take a few minutes for the connection to appear as active after installation.

• If it doesn’t connect after 10–15 minutes, double-check that:

  • The snippet was added to the correct area of your site.

  • You published the changes.

  • The client ID in the snippet matches your account.

• If you still have issues, contact Pathmonk Support at support@pathmonk.com and share your website URL for a quick review.