# ClearAnalytics for Filament — Your Analytics Inside Your Admin Panel

The open-source ClearAnalytics Filament plugin (v4 and v5) shows visitors, top pages, devices, goals and revenue inside your Laravel admin panel.

By Jasper Koers · Published 2026-06-29

## Key takeaways

- The official ClearAnalytics Filament plugin is open source, MIT-licensed and works with Filament v4 and v5 on Laravel 11, 12 and 13.
- The ClearAnalytics Filament plugin adds an Analytics dashboard and drop-in widgets for visitors, pageviews, top pages, referrers, devices, goals, live visitors and e-commerce revenue.
- The ClearAnalytics Filament plugin is installed with Composer from Packagist and configured with an API token created under Settings → API Tokens.
- The ClearAnalytics Filament plugin only reads aggregated statistics over HTTPS, so no raw tracking data, IP addresses or personal identifiers leave ClearAnalytics.

We're excited to release an **official, open-source Filament plugin** for ClearAnalytics. If you build admin panels with [Filament](https://filamentphp.com), you can now show your privacy-first website analytics right next to the rest of your app — no tab-switching, no Google Analytics, no cookies.

## What it does

The plugin adds a dedicated **Analytics** dashboard to your Filament panel, plus a set of drop-in widgets you can place anywhere. Everything is driven by your live ClearAnalytics data through our official REST API.

- **Overview stat cards** — visitors, pageviews, bounce rate and average visit duration, each with a trend indicator and sparkline
- **Visitors & pageviews chart** — a clean time series over your selected period
- **Breakdown tables** — top pages, referrers, traffic sources, browsers, operating systems, languages and campaigns
- **Devices** — a desktop / mobile / tablet split
- **E-commerce** — revenue, transactions, average order value, top products and a conversion funnel
- **Goals & live visitors** — conversion goals and a realtime active-visitor count

A period filter (24h, 7d, 30d, 90d, 12m or a custom range) and a multi-site switcher sit at the top of the dashboard and apply to every widget at once.

## Install in two minutes

The package is on Packagist and follows the standard Filament plugin conventions:

```bash
composer require clearanalytics/filament-clearanalytics
```

Add your API token to `.env` — create one under **Settings → API Tokens** in your ClearAnalytics account:

```dotenv
CLEARANALYTICS_API_TOKEN=your-api-token
# Optional: limit to one site. Leave empty for the aggregate of all sites.
CLEARANALYTICS_SITE_ID=01JM...
```

Then register the plugin in your panel provider:

```php
use ClearAnalytics\Filament\ClearAnalyticsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(ClearAnalyticsPlugin::make());
}
```

That's it — an **Analytics** item appears in your panel navigation, ready to go.

## Privacy-first by design

The plugin only ever reads aggregated statistics over HTTPS. No raw tracking data, IP addresses or personal identifiers leave ClearAnalytics — your admin panel simply renders the same privacy-first, EU-hosted numbers you already see in your dashboard. API responses are cached to stay within rate limits, and every widget degrades gracefully if the API is briefly unreachable.

## Open source & configurable

The plugin is MIT-licensed and works with Filament v4 and v5 on Laravel 11, 12 and 13. You can toggle whole widget groups (e-commerce, goals, live), choose which widgets appear on your main dashboard, and configure everything per panel with a fluent API. Found a bug or want a feature? Issues and pull requests are welcome.

- **Source & docs:** [github.com/ClearAnalytics/filament-clearanalytics](https://github.com/ClearAnalytics/filament-clearanalytics)
- **Package:** [packagist.org/packages/clearanalytics/filament-clearanalytics](https://packagist.org/packages/clearanalytics/filament-clearanalytics)

Looking for other ways to connect ClearAnalytics — Power BI, BigQuery, AI assistants or the raw REST API? Have a look at our [integrations page](/integrations).

Happy building!

## Frequently asked questions

### How do I show website analytics in a Filament admin panel?

Install the ClearAnalytics Filament plugin with `composer require clearanalytics/filament-clearanalytics`, add your API token to `.env` and register `ClearAnalyticsPlugin::make()` in your panel provider. An Analytics item then appears in the panel navigation.

### Which Filament and Laravel versions does the ClearAnalytics plugin support?

The plugin works with Filament v4 and v5 on Laravel 11, 12 and 13.

### Can the Filament plugin show data for one site or for all my sites?

Both. Set `CLEARANALYTICS_SITE_ID` to limit it to one site, or leave it empty for the aggregate of all sites; a multi-site switcher on the dashboard lets you change it there too.

### Is the ClearAnalytics Filament plugin free?

Yes. The plugin is open source under the MIT licence, with source and docs on GitHub.

Source: https://clearanalytics.eu/blog/clearanalytics-for-filament
