How to install Attriboo on Hugo
Add Attriboo to the Hugo template that renders the head of your pages, then rebuild the site. Changing the source template keeps the script in later builds.
Instructions reviewed
Before you start
You need the Hugo source and build/deployment access. Locate your theme’s documented head extension or the shared base template. Modern projects may use layouts/baseof.html and layouts/_partials; older themes may use layouts/_default and layouts/partials.
Add the published domain in Attriboo. Keep one tracking installation and preserve your site’s consent choices. Your website ID is public; private API keys do not belong in the page script.
Copy the script for this website
- Choose your website in Attriboo.
Check the address in the website selector. Add the website first if it is not listed.
- Open Setup and choose Hugo.
Under Add the tracking script to your website, find Where is your site built? Choose this platform, then use Copy beside Your code. This gives you the right code format with your website ID filled in.
Add Attriboo to Hugo
Find this setting
- Hugo source
- Theme head extension or baseof.html
- Inside <head>
- Build and publish
- Find the existing template that renders head.
Prefer the theme’s documented custom-head hook; otherwise use a project-level template override that preserves the theme markup.
- Paste the HTML script from Setup inside that head.
Check that both the homepage and content pages use the template.
- Run your normal Hugo production build and publish the generated site.
Recheck the live domain after the deployment.
<script defer data-site-id="site_YOUR_WEBSITE_ID" src="https://www.attriboo.com/t.js"></script>Check this platform’s behavior
Do not edit only public/index.html: the next Hugo build can replace it. Avoid a second installation through a theme analytics setting. Theme updates can change hooks, so recheck tracking after updating.
Check that page visits reach Attriboo
- Open the published website in another tab.
Use the address your customers visit. Make your normal tracking choice if a consent banner appears.
- Return to the same website in Attriboo → Setup.
Select Test Connection. Look for a successful result such as Verified Live or activity on the correct address.
- Follow an internal link, then use your browser’s Back button.
Check those paths in the Pages view for the current reporting dates. Allow the reports to refresh. An active connection alone does not confirm every page change.
Connect visits to recorded revenue
Installing the script records website activity. To bring sales into Attriboo, connect the service you use to collect payments in Setup as well. Then compare the recorded sources and customer journeys behind your sales.
A payment imported from before tracking was installed may have no matching visit. Installing today does not recreate old website activity.
Hugo references
These placement instructions were reviewed against the platform’s documentation and Attriboo’s current tracker. Check the published site after deployment, theme changes or navigation changes.
You are done when
The published Hugo site loads one Attriboo tracker and the expected page visits reach the selected website. Sales reporting is checked separately.
Still need a hand?
Send a question without needing to sign in.