--- title: "Configuration" date: 2025-02-24 author: "Jeroen Moolenschot" --- # Configuration Joomill Tag Manager adds all your analytics, marketing and site verification tags to your Joomla site from one place. This guide explains every setting in the plugin. ## Where to find the settings In your Joomla administrator, go to **System → Manage → Plugins**, search for **Tag Manager** and open **System - Joomill Tag Manager**. The plugin is enabled automatically when you install it, so you can go straight to its options. The **Help** button in the toolbar links back to this documentation. The settings are split over two tabs: **Basic** (all the built-in services and the site verification tags) and **Advanced** (three custom code fields). ## How it works - **Fill in only what you need.** Every service is independent. A tag is only added when its field is filled in and the value passes a format check. Leave a field empty and nothing is output for it. - **Front end only.** Tags are never injected into the administrator area, only on the public site. - **Correct placement, automatically.** Each snippet is placed where the provider expects it. The Google Tag Manager noscript code is placed directly after the opening `` tag, and the LinkedIn tag is placed just before the closing `` tag. - **Format is validated.** Each ID is checked against its expected format (for example `GTM-XXXX` or `G-XXXX`) and escaped before output. If you paste a value in the wrong format, nothing is injected for that field. If a tag does not appear on your site, check the format of the value first. - **Verification versus tracking.** Site verification meta tags are always output, including for excluded user groups. The tracking scripts respect the exclude list. ## Basic settings ### General | | | | --- | --- | | Exclude User Groups | Logged-in users in the selected user groups are not tracked. Useful to keep your own visits, and those of administrators and editors, out of your statistics. Site verification meta tags are still output for these users. Select one or more Joomla user groups. Leave empty to track everyone. | ### Google | | | | --- | --- | | Google Site Verification | Adds the `google-site-verification` meta tag so you can verify ownership in Google Search Console. In Search Console, choose the HTML tag method and copy the value of the `content` attribute. | | Tag Manager ID | Your GTM container ID, format `GTM-XXXXXXX`. Found in your Google Tag Manager workspace, top of the screen. Loads your Google Tag Manager container (script in the head, noscript iframe right after ``). Preconnect hints are added so the container loads faster. | | Google Analytics 4 ID | Your GA4 Measurement ID, format `G-XXXXXXXXXX`. Found in Google Analytics under Admin, Data Streams, your web stream. | Note: the Tag Manager ID and the Google Analytics 4 ID are two different things. Use Tag Manager if you manage tags through GTM, or use the GA4 ID to load Google Analytics directly. You can also use both. ### Microsoft | | | | --- | --- | | Bing Site Verification | Paste only the verification token. In Bing Webmaster Tools, choose the meta tag method and copy the `content` value. Adds the `msvalidate.01` meta tag to verify your site in Bing Webmaster Tools. | | Microsoft Clarity Project ID | Your Clarity Project ID (a short string of letters and digits). Found in your Clarity project under Settings, Overview. Loads Microsoft Clarity for heatmaps and session recordings. | ### Facebook | | | | --- | --- | | Facebook Domain Verification | Paste only the verification token. In Meta Business Settings, under Brand Safety and Domains, choose the meta tag method and copy the `content` value. Adds the `facebook-domain-verification` meta tag to verify your domain with Meta. | | Facebook Pixel ID | Your Pixel ID, digits only. Found in Meta Events Manager, under your data source. Loads the Meta (Facebook) Pixel with a PageView event and a noscript fallback, for ads and conversion tracking. | ### LinkedIn | | | | --- | --- | | LinkedIn Partner ID | Your Partner ID, digits only. Found in LinkedIn Campaign Manager under the Insight Tag settings. Loads the LinkedIn Insight Tag, placed just before the closing `` tag as LinkedIn recommends, for campaign conversion tracking and audiences. | ### Pinterest | | | | --- | --- | | Pinterest Site Verification | Paste only the verification token. In your Pinterest business account, choose the meta tag method when claiming your website and copy the `content` value. Adds the `p:domain_verify` meta tag to claim your website on Pinterest. | ### Leadinfo | | | | --- | --- | | Leadinfo ID | Your Leadinfo ID, format `LI-XXXX`. Found in your Leadinfo account under the tracking code or installation settings. Loads the Leadinfo tracking script, which identifies the companies that visit your site. | ### Matomo | | | | --- | --- | | Matomo Server URL | The full URL of your (self-hosted) Matomo install, for example `https://stats.example.com`. Both the Matomo Server URL and the Matomo Site ID are required before the tracking code is added. | | Matomo Site ID | A number. Found in Matomo under Administration, Websites, Manage. Tells Matomo which website this data belongs to. | ### Plausible | | | | --- | --- | | Plausible Domain | The domain exactly as registered in Plausible, for example `www.example.com`. Loads Plausible Analytics for the given domain. This is the only required Plausible field. | | Plausible Server URL | Leave empty to use `plausible.io`. For a self-hosted instance, enter its URL, for example `https://plausible.example.com`. Lets you point to a self-hosted Plausible instance instead of the cloud service. | **Privacy friendly options.** Matomo (self-hosted) and Plausible are the privacy friendly analytics options. You decide which services to load, so you can run a lightweight or cookieless setup if that suits your site. ## Advanced settings: custom code The Advanced tab has three code editors for anything that is not in the built-in list, such as another tracking snippet, schema markup, an A/B testing script or a chat widget. Your code is inserted exactly as you write it. | | | | --- | --- | | Custom Head Code | Right before the closing `` tag. | | Custom Body Begin Code | Right after the opening `` tag. | | Custom Body End Code | Right before the closing `` tag. | **Use with care.** The custom code fields are raw and are not validated, so you are responsible for the code you add here. Make sure it is valid HTML or JavaScript, otherwise it can break the front end of your site. ## Tips and troubleshooting - **For verification fields, enter only the token.** Do not paste the full `` tag, just the value of its `content` attribute. The plugin builds the meta tag for you. - **A tag does not appear?** Check the format of the value. An ID in the wrong format is ignored on purpose. Also remember that tracking is output on the front end only, not in the administrator. - **Testing as a logged-in admin?** If your own group is in the Exclude User Groups list, you will not see the tracking scripts while logged in. Check in a private window or while logged out. - **Clear your cache.** If you use page caching (Joomla cache or a third-party cache), clear it after changing a setting so the new tags appear. - **Consent and privacy.** Tag Manager outputs the tags you configure. It is not a cookie consent banner, so make sure your privacy policy and consent setup match the services you enable. Joomill Tag Manager is free and open source (GPL). Need help? Contact me through [the contact page](https://www.joomill-extensions.com/contact).