PHPackages                             jeffersongoncalves/laravel-umami - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. jeffersongoncalves/laravel-umami

ActiveLibrary[Templating & Views](/categories/templating)

jeffersongoncalves/laravel-umami
================================

This Laravel package seamlessly integrates Umami analytics into your Blade templates. Easily track website visits and user engagement directly within your Laravel application, providing valuable insights into your website's performance. This package simplifies the integration process, saving you time and effort. With minimal configuration, you can leverage Umami's powerful analytics features to gain a clearer understanding of your audience and website usage.

v2.0.2(2mo ago)4534↓33.3%1MITBladePHP ^8.2|^8.3CI passing

Since Mar 4Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/laravel-umami)[ Packagist](https://packagist.org/packages/jeffersongoncalves/laravel-umami)[ Docs](https://github.com/jeffersongoncalves/laravel-umami)[ RSS](/packages/jeffersongoncalves-laravel-umami/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (7)Versions (8)Used By (1)

[![Laravel Umami](https://raw.githubusercontent.com/jeffersongoncalves/laravel-umami/master/art/jeffersongoncalves-laravel-umami.png)](https://raw.githubusercontent.com/jeffersongoncalves/laravel-umami/master/art/jeffersongoncalves-laravel-umami.png)

Laravel Umami
=============

[](#laravel-umami)

[![Latest Version on Packagist](https://camo.githubusercontent.com/cbadfc9ec909a3a7679d2c04717e35cbbaa7cd85d6d1b6d207055f0f766eb333/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d756d616d692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/laravel-umami)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/97d4e1cb3ed0936185b2f06094c1ae80d31030711f701d0d1c4b2bf72461d3fb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d756d616d692f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d6173746572266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/laravel-umami/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/c4466fd6836cdad10f59394e25f9e16b2f057d30d981fb6156736ba68ce47fc5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f6c61726176656c2d756d616d692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/laravel-umami)

This Laravel package seamlessly integrates Umami analytics into your Blade templates. Easily track website visits and user engagement directly within your Laravel application, providing valuable insights into your website's performance. This package simplifies the integration process, saving you time and effort. With minimal configuration, you can leverage Umami's powerful analytics features to gain a clearer understanding of your audience and website usage.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11+
- [spatie/laravel-settings](https://github.com/spatie/laravel-settings) configured (the `settings` table must exist)

Installation
------------

[](#installation)

Install the package via composer:

```
composer require jeffersongoncalves/laravel-umami
```

If you haven't already, publish the `spatie/laravel-settings` migration to create the `settings` table:

```
php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"
```

Then publish and run the Umami settings migration:

```
php artisan vendor:publish --tag=umami-settings-migrations
php artisan migrate
```

Usage
-----

[](#usage)

Add the Umami script to your Blade layout (typically in the `` section):

```
@include('umami::script')
```

### Configuring Settings

[](#configuring-settings)

Settings are stored in the database and can be managed via code:

```
use JeffersonGoncalves\Umami\Settings\UmamiSettings;

$settings = app(UmamiSettings::class);
$settings->website_id = 'your-website-id';
$settings->host_analytics = 'https://your-umami-instance.com';
$settings->save();
```

### Available Settings

[](#available-settings)

PropertyTypeDefaultDescription`website_id``?string``null`Your Umami website ID (required for tracking)`host_analytics``string``https://cloud.umami.is`URL of your Umami instance`host_url``?string``null`Override data destination URL`auto_track``bool``true`Automatically track pageviews and events`domains``?string``null`Comma-delimited list of allowed domains`tag``?string``null`Tag to group events in the dashboard`exclude_search``bool``false`Exclude search parameters from URL`exclude_hash``bool``false`Exclude hash value from URLTesting
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Jefferson Goncalves](https://github.com/jeffersongoncalves)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance88

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~71 days

Recently: every ~89 days

Total

6

Last Release

83d ago

Major Versions

v1.1.0 → v2.0.02026-02-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (36 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (1 commits)")

---

Tags

analyticsbladecomposerjeffersongoncalveslaravellaravel-packagephpprivacy-friendlyspatie-laravel-settingsumamiumami-analyticsweb-analyticslaraveljeffersongoncalveslaravel-umami

###  Code Quality

TestsPest

Static AnalysisPHPStan

### Embed Badge

![Health badge](/badges/jeffersongoncalves-laravel-umami/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-laravel-umami/health.svg)](https://phpackages.com/packages/jeffersongoncalves-laravel-umami)
```

###  Alternatives

[ryangjchandler/blade-capture-directive

Create inline partials in your Blade templates with ease.

8222.2M12](/packages/ryangjchandler-blade-capture-directive)[daikazu/laravel-glider

Start using Glide on-the-fly instantly in your Laravel blade templates.

882.3k](/packages/daikazu-laravel-glider)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)