> ## Documentation Index
> Fetch the complete documentation index at: https://docs.betterumami.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: Set Up Betterumami Analytics in Minutes

> Create a Betterumami account, add your website, and install the tracking script to start collecting privacy-first analytics in under five minutes.

This guide walks you through everything you need to go from a blank slate to live analytics data. The entire process takes less than five minutes: create an account, verify your email, add your website, and paste one script tag into your HTML. Once the script is live, data begins flowing into your dashboard immediately — no sampling, no delays, no cookies.

## Step-by-step setup

**1. Create your account**

Go to [betterumami.com/register](https://www.betterumami.com/register). Enter your name, email address, and a password, then click **Create account**. You can also sign up instantly using **Sign in with Google**.

> [!NOTE]
>
> By creating an account you agree to the Betterumami [Terms](https://www.betterumami.com/terms) and [Privacy Policy](https://www.betterumami.com/privacy).

**2. Verify your email address**

After signing up, Betterumami sends a 6-digit verification code to the email address you registered with. Enter that code when prompted to activate your account. Check your spam folder if the email doesn't arrive within a couple of minutes.

**3. Add your website**

Once you are logged in, click **Websites** in the left sidebar, then click the **Add website** button in the top-right corner. Fill in the **Name** and **Domain** fields and click **Save**.

* **Name** — A human-readable label for the site (e.g. `My Blog`). This is only used inside the dashboard.
* **Domain** — The actual domain of your website (e.g. `example.com`). This is used to filter your own domain out of referrer reports.

See [Add a Website](https://docs.betterumami.com/docs/add-a-website.md) for full details.

**4. Copy the tracking script**

After saving your website, click the **Edit** button next to it. Scroll down to the **Tracking code** section and copy the script tag that appears there. It looks like this:

```html theme={null}
<script async src="https://cloud.umami.is/script.js" data-website-id="your-website-id"></script>
```

The `data-website-id` attribute contains the unique ID that links collected events to your specific website in the dashboard.

**5. Install the script on your website**

Paste the copied script tag into the `<head>` section of every page you want to track. For most sites and frameworks, this means adding it to a shared layout or template file so it is included automatically on every page.

```html theme={null}
<head>
  <meta charset="UTF-8" />
  <title>My Website</title>
  <!-- Betterumami tracking script -->
  <script async src="https://cloud.umami.is/script.js" data-website-id="your-website-id"></script>
</head>
```

> [!TIP]
>
> If you are using **Next.js**, use the [`next/script`](https://nextjs.org/docs/app/api-reference/components/script) component rather than a plain `<script>` tag to ensure correct loading behaviour.

**6. Verify data is appearing**

Visit your website in a browser. Then return to your Betterumami dashboard — you should see a pageview appear in real time. If you are running a single-page application (SPA), Betterumami automatically detects client-side navigation, so no extra configuration is needed.

## Troubleshooting

If data is not showing up after you install the script, check the following:

> [accordion] Data not appearing in the dashboard
>
> Open your browser developer tools (press `F12`) and go to the **Network** tab. Reload the page and look for a request to `cloud.umami.is`. If no request appears, the script tag may not have been placed correctly, or the file containing the `<head>` section may not have been saved and redeployed.

> [accordion] Script blocked by an ad blocker
>
> Some ad blockers block analytics scripts, including privacy-respecting ones like Betterumami. This means traffic from visitors using ad blockers will not be recorded. To reduce data loss, you can proxy the script through your own domain. See [Install Tracking Script](https://docs.betterumami.com/docs/install-tracking-script.md) for guidance on the ad blockers workaround.

> [accordion] Script loads but no events fire
>
> Confirm that the `data-website-id` attribute in your script tag matches the website ID shown in the Betterumami dashboard under **Edit** for that website. A mismatched or missing ID is the most common cause of the script loading but sending no data.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.