<h1>Tracker configuration</h1>
<p>The Umami tracker provides several properties that allow you to configure its behavior.</p>
<h3>data-host-url</h3>
<p>By default, Umami will send data to wherever the script is located. You can override this to send data
to another location.</p>
<p>Usage:</p>
<pre><code>&#x3C;script async defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-host-url="http://stats.mywebsite.com"
>&#x3C;/script>
</code></pre>
<h3>data-auto-track</h3>
<p>By default, Umami tracks all pageviews and events for you automatically. You can disable this behavior and
track events yourself using the <a href="/docs/tracker-functions">tracker functions</a>.</p>
<p>Usage:</p>
<pre><code>&#x3C;script async defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-auto-track="false"
>&#x3C;/script>
</code></pre>
<h3>data-do-not-track</h3>
<p>You can configure Umami to respect the visitor's <strong>Do Not Track</strong> setting. </p>
<p>Usage:</p>
<pre><code>&#x3C;script async defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-do-not-track="true"
>&#x3C;/script>
</code></pre>
<h3>data-cache</h3>
<p>If you get a lot of pageviews from the same user, for example in a forum website, you can cache some data to
improve the performance of the tracking script.</p>
<p><em>Note: This will use session storage so you may need to inform your users.</em></p>
<p>Usage:</p>
<pre><code>&#x3C;script async defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-cache="true"
>&#x3C;/script>
</code></pre>
<h3>data-domains</h3>
<p>If you want the tracker to only run on specific domains, you can add them to your tracker script. This is a comma delimited list of domain names. Helps if you are working in a staging/development environment.</p>
<p>Usage:</p>
<pre><code>&#x3C;script async defer
  src="http://mywebsite.com/umami.js"
  data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"
  data-domains="mywebsite.com,mywebsite2.com"
>&#x3C;/script>
</code></pre>
<h3>Google Tag Manager</h3>
<p>Google Tag Manager will strip the attributes from the tracker, so you can bypass this by using the format below.</p>
<p>Usage:</p>
<pre><code>&#x3C;script>
  (function() {
    var el = document.createElement("script");
    el.setAttribute("src", "http://mywebsite.com/umami.js");
    el.setAttribute("data-website-id", "94db1cb1-74f4-4a40-ad6c-962362670409");
    document.body.appendChild(el);
  })();
&#x3C;/script>
</code></pre>


Documentation

Basics

Advanced

Guides