"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; function _createMdxContent(props) { const _components = { a: "a", code: "code", h3: "h3", p: "p", pre: "pre", span: "span", ...props.components }; return _jsxs(_Fragment, { children: [_jsx(_components.p, { children: "The Umami tracker provides several properties that allow you to configure its behavior." }), "\n", _jsx(_components.h3, { id: "data-host-url", children: "data-host-url" }), "\n", _jsx(_components.p, { children: "By default, Umami will send data to wherever the script is located. You can override this to send data\nto another location." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-host-url" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://stats.mywebsite.com\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-auto-track", children: "data-auto-track" }), "\n", _jsxs(_components.p, { children: ["By default, Umami tracks all pageviews and events for you automatically. You can disable this behavior and\ntrack events yourself using the ", _jsx(_components.a, { href: "/docs/tracker-functions", children: "tracker functions" }), "."] }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-auto-track" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"false\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-domains", children: "data-domains" }), "\n", _jsx(_components.p, { children: "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." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-domains" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"mywebsite.com,mywebsite2.com\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-tag", children: "data-tag" }), "\n", _jsx(_components.p, { children: "If you want the tracker to collect events under a specific tag. Events can be filtered in the dashboard by a specific tag." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-tag" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"umami-eu\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-exclude-search", children: "data-exclude-search" }), "\n", _jsx(_components.p, { children: "If you don't want to collect search parameters from the URL." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-exclude-search" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"true\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-exclude-hash", children: "data-exclude-hash" }), "\n", _jsx(_components.p, { children: "If you don't want to collect the hash value from the URL." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-exclude-hash" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"true\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-do-not-track", children: "data-do-not-track" }), "\n", _jsxs(_components.p, { children: ["Respect user's ", _jsx(_components.a, { href: "https://developer.mozilla.org/en-US/docs/Web/API/Navigator/doNotTrack", children: "Do Not Track" }), " browser setting."] }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-do-not-track" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"true\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) }), "\n", _jsx(_components.h3, { id: "data-before-send", children: "data-before-send" }), "\n", _jsx(_components.p, { children: "Allows you to specify a function that will be called before data is sent.\nYou can then inspect and modify the payload or cancel the send entirely.\nThe function will take two parameters, type and payload.\nTo continue with sending, you return a payload object.\nTo cancel the send, return a false-y value." }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-javascript", children: [_jsx(_components.span, { className: "hljs-keyword", children: "function" }), " ", _jsx(_components.span, { className: "hljs-title function_", children: "beforeSendHandler" }), "(", _jsx(_components.span, { className: "hljs-params", children: "type, payload" }), ") {\n ", _jsx(_components.span, { className: "hljs-keyword", children: "if" }), " (", _jsx(_components.span, { className: "hljs-title function_", children: "checkPayload" }), "(payload)) {\n ", _jsx(_components.span, { className: "hljs-keyword", children: "return" }), " payload;\n }\n ", _jsx(_components.span, { className: "hljs-keyword", children: "return" }), " ", _jsx(_components.span, { className: "hljs-literal", children: "false" }), ";\n}\n"] }) }), "\n", _jsx(_components.pre, { children: _jsxs(_components.code, { className: "hljs language-html", children: [_jsxs(_components.span, { className: "hljs-tag", children: ["<", _jsx(_components.span, { className: "hljs-name", children: "script" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "defer" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "src" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"http://mywebsite.com/umami.js\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-website-id" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"94db1cb1-74f4-4a40-ad6c-962362670409\"" }), "\n ", _jsx(_components.span, { className: "hljs-attr", children: "data-before-send" }), "=", _jsx(_components.span, { className: "hljs-string", children: "\"beforeSendHandler\"" }), "\n>"] }), _jsxs(_components.span, { className: "hljs-tag", children: [""] }), "\n"] }) })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = props.components || ({}); return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { default: MDXContent };