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

# Umami Analytics source

> Connect Umami to Chartcastr for automated privacy-friendly web analytics charts. Track visitor counts, pageviews, referrers, and device breakdowns.

## Overview

Use Umami as a data source for Chartcastr. Connect your Umami workspace with a website ID and API token, then deliver traffic and breakdown charts to Slack or email with AI-generated analysis.

Chartcastr connects with read-only access to your Umami analytics data. No write permissions are requested.

## Setup

<Steps>
  <Step title="Create an Umami API token">
    In Umami, go to **Settings → API Keys** and create a token with access to the website you want to report on.
  </Step>

  <Step title="Find your Website ID">
    Open the relevant site in Umami and copy the **Website ID** from the settings or site details screen.
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, create a new source and choose **Umami Analytics**. Enter your Umami base URL, website ID, and API token, then validate the connection.
  </Step>

  <Step title="Select a metric">
    Choose the traffic or breakdown metric you want to track. Each metric becomes its own source.
  </Step>

  <Step title="Create a connection">
    Pick a destination, choose your schedule, and optionally enable AI summaries.
  </Step>
</Steps>

## Available Metrics

Chartcastr supports **11 pre-built Umami metrics** across traffic trends and breakdowns.

<CardGroup cols={2}>
  <Card title="Traffic" icon="chart-line">
    Pageviews, visitors, sessions, bounce rate, and average visit duration over time.
  </Card>

  <Card title="Breakdowns" icon="chart-pie">
    Top pages, referrers, browsers, operating systems, devices, and countries.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/umami/available-charts">
  See the full list of Umami metrics with chart types and descriptions.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Umami charts to Slack with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule Umami reports to any inbox or distribution list.
  </Card>
</CardGroup>
