How to add your bot detection tag, quick links

Our Bot Detection Tag is what makes Beacon unique. It’s what we use to close the gap between your digital marketing activities and the resulting visitor actions on your website, allowing you to intelligently measure traffic and attribute website events and conversion to specific marketing activities.

When you drive people to your website via a Beacon Link, something pretty nifty happens – we analyse and report all visitor behaviour on your website, giving you the knowledge to attribute website actions to individual digital marketing assets.

Beacon and Cookies – Beacon must not be part of your cookie consent process

Beacon is functional security software that does not use cookies; therefore it must not to be part of your cookie consent process. You do not need to make reference to the Beacon platform or Beaconsoft Limited in your Cookie Policy or Cookie Notice, nor in your Privacy Policy.

For more information see our GDPR compliance and cookie notice policy guidelines.

Once you have installed the code learn how to verify it is loading correctly here.

Get started in seconds…

Using Google Tag Manager

Google Tag Manager

Go to Google Tag Manager and log in to your account or create a new one. Once you’re in, select New Tag.

On the next page, label the new tag Beacon, and select Custom HTML Tag.

Paste in the Beacon bot detection tag from lower down this page and for Triggering select All Pages.

Beacon Code

Name your Tag

Click Submit then Click Publish. 

Add Beacon in seconds with our official WordPress plugin

Download our official WordPress plugin

If your website runs on a WordPress installation that you have hosted yourself, you can download our handy plugin here.

  1. Upload this to your wp-content/plugins folder.
  2. Then in your WordPress administration panel go to Plugins
  3. Click ‘Add new’
  4. In the search bar on the right hand side, type “Beacon Web Analytics” and find “Beacon Web Analytics for WordPress”
  5. Click install, then Activate and you’re done!

If your site is hosted on, you will need the business plan in order to add the Beacon plugin. If you have this plan, navigate to your WordPress plugins section by clicking Plugins on the left navigation bar. From here you should see an Upload Plugin button.

Adding the Beacon bot detection tag manually

The code should be placed on every page you wish to track. We recommend adding the tag to your website footer, just before the closing /body tag.

If you have access to your website code, you can add it manually. Simply paste the following script into each page you wish to track, or ideally your footer file as described above.

<script type="text/javascript">
window.bwai = {"formIntegration":true};(function(a, d, w){var h= d.getElementsByTagName(a[0])[0]; var s= d.createElement(a[1]);s.type= a[2]; s.src= a[3]; s.setAttribute("integrity", a[4]);s.setAttribute("crossorigin", "anonymous");h.appendChild(s);})(['head', 'script', 'text/javascript', '//',
'sha512-13GUu5vadQ2mQwPDwj2jREx1SnYNp0dg5UoI3RN+8Vo+AGFMnmmibbqC4XKnkxHpyK45GtYA2tPzuQJQQHvGgg=='], document, window);

Form tracking: GDPR Compliance

If you would like us not to capture form data, which may reduce our ability to monitor goals related to form fills, change window.bwai = {"formIntegration":true}; to be window.bwai = {"formIntegration":false}; in the script.

Integrating Beacon bot detection with other platforms


If your website runs on Squarespace, you can manually add the code above by inserting it into the site footer. This is described in a video by the Squarespace team you can find here. Or follow these instructions.

Step 1 – Open Code Injection

In the Home Menu, click Settings, click Advanced, and then click Code Injection.

Step 2 – Add the Beacon tag

Add the Beacon tag, from above, into the appropriate Code Injection fields for the footer.

Code added here is injected before the closing </body>  tag on every page in your site.


If you have built your website in Shopify, please follow the instructions here.


If your website runs on a custom Magento theme, you can get instructions for adding custom Javascript here.


If you have built your website in Wix, please follow the instructions here.

You will need to add the code to all pages and ‘load code’ on each new page. Also, place the code in the ‘head’ when prompted.

Other website builders

If your website runs on another online website building tool such as; Weebly,  1 & 1, etc. you will need to locate the area for adding scripts (just as you do when installing Google Analytics) and place your Beacon bot detection tag there.

For more information see our GDPR compliance and cookie notice policy guidelines.

Once you have installed the code learn how to verify it is loading correctly here.

Still need help?

If you need further assistance in installing your Beacon bot detection tag, or for us to verify that your code is correctly set up, please get in touch with us and we’ll be happy to help.