Add Google Analytics in HUGO 🌟
how to add google analytics in hugo To add Google Analytics to your Hugo site, follow these clear steps: 1. Create a Google Analytics Account and Get Your Measurement ID Go to Google Analytics and sign in or create an account. Set up a new property for your website and note your Measurement ID (e.g., G-XXXXXXXXXX for GA4 or UA-XXXXXXXX-X for Universal Analytics)12. 2. Configure Your Hugo Site A. Add Your Measurement ID to config.toml Open your site’s config.toml file and add this line at the top level (replace with your actual ID):
HUGO - This article is part of a series.
how to add google analytics in hugo
To add Google Analytics to your Hugo site, follow these clear steps:
1. Create a Google Analytics Account and Get Your Measurement ID
- Go to Google Analytics and sign in or create an account.
- Set up a new property for your website and note your Measurement ID (e.g.,
G-XXXXXXXXXXfor GA4 orUA-XXXXXXXX-Xfor Universal Analytics)12.
2. Configure Your Hugo Site
A. Add Your Measurement ID to config.toml
Open your site’s config.toml file and add this line at the top level (replace with your actual ID):
googleAnalytics = "G-XXXXXXXXXX"B. Ensure the Analytics Template is Included in Your Theme
Hugo has a built-in template for Google Analytics. You need to include it in your site’s <head> section.
If Your Theme Already Supports Analytics:
- Most modern Hugo themes automatically include the Google Analytics template if the
googleAnalyticsvalue is set inconfig.toml. - No further action needed.
If Your Theme Does NOT Include It:
- Copy your theme’s
header.html(often atthemes/yourtheme/layouts/partials/header.html) to your site’s ownlayouts/partials/header.htmlto avoid editing theme files directly32. - Add the following line inside the
<head>section:
{{ template "_internal/google_analytics.html" . }}- For GA4, you may also add:
{{ template "_internal/google_analytics_async.html" . }}3. Build and Deploy Your Site
- Run
hugoto build your site. - Deploy as usual.
4. Verify Tracking
- Visit your site and check the Real-Time section in Google Analytics to confirm data is being received.
- If you use browser privacy plugins, try in an incognito window to ensure scripts aren’t blocked3.
Optional: Custom GA4 Integration
If you want more control or your theme doesn’t support Hugo’s built-in templates, you can create a custom partial (e.g., analytics-gtag.html) and include the GA4 script manually4:
In config.toml:
[params]
googleAnalyticsID = "G-XXXXXXXXXX"In /layouts/partials/analytics-gtag.html:
<script async src="https://www.googletagmanager.com/gtag/js?id={{ .Site.Params.googleAnalyticsID }}"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', '{{ .Site.Params.googleAnalyticsID }}');
</script>Then call this partial in your base template (baseof.html):
{{ if .Site.Params.googleAnalyticsID }}
{{ partial "analytics-gtag.html" . }}
{{ end }}Summary Table
| Step | Action |
|---|---|
| 1. Get Measurement ID | From Google Analytics account |
| 2. Edit config.toml | Add googleAnalytics = "G-XXXXXXXXXX" |
| 3. Check theme header | Ensure {{ template "_internal/google_analytics.html" . }} is included |
| 4. Build & Deploy | Run hugo and deploy your site |
| 5. Verify | Check Google Analytics dashboard |
That’s it! Your Hugo site will now track visitors using Google Analytics1324.
Similar Articles
Monetize Your Hugo Site with Google AdSense 💰
integrate google adsence in hugo with ads customization To integrate Google AdSense into your Hugo website with ad customization, follow these clear steps. This process works for most Hugo themes (including PaperMod, Blowfish, Academic, and others) and allows you to control where and how ads appear. 1. Prerequisites Google AdSense account (sign up at Google AdSense) Hugo-based website (already set up and deployed) 2. Add Your Website to Google AdSense Sign in to Google AdSense. Go to Sites > Add Site. Enter your website URL and save. Copy the AdSense code snippet provided (it looks like a <script> tag). 3. Insert AdSense Code into Hugo A. For Site-Wide (Auto Ads) Integration Create a Partial for AdSense Script: Create a file named adsense.html in layouts/partials/google/ (create folders if they don’t exist). Paste the AdSense Script: Add the code snippet provided by AdSense: <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=YOUR-ADSENSE-CLIENT-ID" crossorigin="anonymous"></script> - Replace `YOUR-ADSENSE-CLIENT-ID` with your actual AdSense client ID. Include the Partial in Your Site’s <head>: For many themes (like PaperMod, Blowfish, Academic), create or edit layouts/partials/extend_head.html or your theme’s equivalent head partial. Add: {{ partial "google/adsense.html" . }} - This ensures the AdSense script loads on every page. B. For Custom Ad Placement (Manual Ads) Create Ad Units in AdSense: In AdSense, go to Ads > By ad unit. Create and configure a new ad unit (e.g., Display ad, In-article ad). Copy the HTML code provided for the ad unit. Insert Ad Code Where You Want Ads to Appear: For example, to show an ad in your post content, create a partial such as layouts/partials/ads-in-article.html and paste the ad unit code there. In your content template (e.g., layouts/_default/single.html), add: {{ partial "ads-in-article.html" . }} - Place this line where you want the ad to appear (top, middle, bottom, etc.). 4. Upload ads.txt for AdSense Verification Download the ads.txt file from AdSense (after approval). Place it in your Hugo site’s /static directory. When deployed, it will be available at https://yourdomain.com/ads.txt123. 5. Customize Ad Display and Types In your AdSense dashboard, use the Ads tab to: Enable/disable Auto ads. Control ad formats (e.g., in-page, anchor, vignette). Preview and adjust ad placements with the visual editor. For manual ads, you can add different ad units to different partials or templates for fine-grained control. 6. Deploy and Request Review Deploy your Hugo site as usual. In AdSense, request a review if prompted. Once approved, ads will begin to appear. 7. Summary Table Step Action 1. AdSense Account Sign up and add your site 2. Get Script Copy AdSense script or ad unit code 3. Hugo Integration Place script in partial (adsense.html), include in head or content templates 4. ads.txt Place in /static directory 5. Customize Ads Use AdSense dashboard for settings, or place manual units as desired 6. Deploy & Review Deploy site, request review, and monitor ad performance 8. Tips for Best Results Test locally and in production to ensure ads display correctly. Use partials for modular, reusable ad placement. Avoid too many ads to maintain a good user experience. Comply with AdSense policies to avoid account issues. References:
Recommended Articles 📂🔥
Monetize Your Hugo Site with Google AdSense 💰
integrate google adsence in hugo with ads customization To integrate Google AdSense into your Hugo website with ad customization, follow these clear steps. This process works for most Hugo themes (including PaperMod, Blowfish, Academic, and others) and allows you to control where and how ads appear. 1. Prerequisites Google AdSense account (sign up at Google AdSense) Hugo-based website (already set up and deployed) 2. Add Your Website to Google AdSense Sign in to Google AdSense. Go to Sites > Add Site. Enter your website URL and save. Copy the AdSense code snippet provided (it looks like a <script> tag). 3. Insert AdSense Code into Hugo A. For Site-Wide (Auto Ads) Integration Create a Partial for AdSense Script: Create a file named adsense.html in layouts/partials/google/ (create folders if they don’t exist). Paste the AdSense Script: Add the code snippet provided by AdSense: <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=YOUR-ADSENSE-CLIENT-ID" crossorigin="anonymous"></script> - Replace `YOUR-ADSENSE-CLIENT-ID` with your actual AdSense client ID. Include the Partial in Your Site’s <head>: For many themes (like PaperMod, Blowfish, Academic), create or edit layouts/partials/extend_head.html or your theme’s equivalent head partial. Add: {{ partial "google/adsense.html" . }} - This ensures the AdSense script loads on every page. B. For Custom Ad Placement (Manual Ads) Create Ad Units in AdSense: In AdSense, go to Ads > By ad unit. Create and configure a new ad unit (e.g., Display ad, In-article ad). Copy the HTML code provided for the ad unit. Insert Ad Code Where You Want Ads to Appear: For example, to show an ad in your post content, create a partial such as layouts/partials/ads-in-article.html and paste the ad unit code there. In your content template (e.g., layouts/_default/single.html), add: {{ partial "ads-in-article.html" . }} - Place this line where you want the ad to appear (top, middle, bottom, etc.). 4. Upload ads.txt for AdSense Verification Download the ads.txt file from AdSense (after approval). Place it in your Hugo site’s /static directory. When deployed, it will be available at https://yourdomain.com/ads.txt123. 5. Customize Ad Display and Types In your AdSense dashboard, use the Ads tab to: Enable/disable Auto ads. Control ad formats (e.g., in-page, anchor, vignette). Preview and adjust ad placements with the visual editor. For manual ads, you can add different ad units to different partials or templates for fine-grained control. 6. Deploy and Request Review Deploy your Hugo site as usual. In AdSense, request a review if prompted. Once approved, ads will begin to appear. 7. Summary Table Step Action 1. AdSense Account Sign up and add your site 2. Get Script Copy AdSense script or ad unit code 3. Hugo Integration Place script in partial (adsense.html), include in head or content templates 4. ads.txt Place in /static directory 5. Customize Ads Use AdSense dashboard for settings, or place manual units as desired 6. Deploy & Review Deploy site, request review, and monitor ad performance 8. Tips for Best Results Test locally and in production to ensure ads display correctly. Use partials for modular, reusable ad placement. Avoid too many ads to maintain a good user experience. Comply with AdSense policies to avoid account issues. References:
