PHPackages                             danielhe4rt/filament-mails - 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. [Admin Panels](/categories/admin)
4. /
5. danielhe4rt/filament-mails

ActiveLibrary[Admin Panels](/categories/admin)

danielhe4rt/filament-mails
==========================

View logged mails and events in a beautiful Filament UI.

0.0.6(7mo ago)032MITPHPPHP ^8.1

Since Jul 14Pushed 7mo agoCompare

[ Source](https://github.com/danielhe4rt/filament-mails)[ Packagist](https://packagist.org/packages/danielhe4rt/filament-mails)[ Docs](https://github.com/Backstage/filament-mails)[ GitHub Sponsors](https://github.com/vormkracht10)[ RSS](/packages/danielhe4rt-filament-mails/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (13)Versions (8)Used By (0)

Filament Mails
==============

[](#filament-mails)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7baf96d33d4daa66bce177aff144bcae9380dc7c43179bda33910018cbc0529c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6261636b73746167657068702f66696c616d656e742d6d61696c732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/backstagephp/filament-mails)[![GitHub Tests Action Status](https://camo.githubusercontent.com/04dafc15b724e41fa21f016aa66423978cc4809717f10eb9a98ca4efb31e5b02/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261636b73746167657068702f66696c616d656e742d6d61696c732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/backstagephp/filament-mails/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/e38e85f33bd0000b59730de754e66d0aad8eb0400592589520ad4500f2c60e9c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261636b73746167657068702f66696c616d656e742d6d61696c732f6669782d7068702d636f64652d7374796c696e672e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/backstagephp/filament-mails/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9ac65d145c19c73b64202d63067470470d1f2cf636294efb58d20c4c54b38eb2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6261636b73746167657068702f66696c616d656e742d6d61696c732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/backstagephp/filament-mails)

Nice to meet you, we're [Backstage](https://backstagephp.com)
-------------------------------------------------------------

[](#nice-to-meet-you-were-backstage)

Hi! We are a web development agency from Nijmegen in the Netherlands and we use Laravel for everything: advanced websites with a lot of bells and whistles and large web applications.

About the package
-----------------

[](#about-the-package)

Filament Mails can collect everything you might want to track about the mails that has been sent by your Filament app. Common use cases are provided in this package:

- Log all sent emails with only specific attributes
- View all sent emails in the browser using the viewer
- Collect feedback about the delivery from email providers using webhooks
- Get automatically notified when email bounces
- Prune logging of emails periodically
- Resend logged email to same or another recipient

Upcoming features
-----------------

[](#upcoming-features)

- We're currently in the process of writing mail events support for other popular email service providers like Resend, SendGrid, Amazon SES and Mailtrap.
- Relate emails being send in Laravel directly to Eloquent models, for example the order confirmation email attached to an Order model.

Why this package
----------------

[](#why-this-package)

Email as a protocol is very error prone. Succesfull email delivery is not guaranteed in any way, so it is best to monitor your email sending realtime. Using external services like Postmark, Mailgun or Resend email gets better by offering things like logging and delivery feedback, but it still needs your attention and can fail silently but horendously. Therefore we created Laravel Mails that fills in all the gaps.

The package is built on top of [Laravel Mails](https://github.com/backstagephp/laravel-mails).

[![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/filament-mails.jpeg)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/filament-mails.jpeg)

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

[](#installation)

You can install the package via composer:

```
composer require backstage/filament-mails
```

You can publish and run the migrations with:

```
php artisan vendor:publish --tag="mails-migrations"
php artisan migrate
```

You can publish the config file with:

```
php artisan vendor:publish --tag="mails-config"
php artisan vendor:publish --tag="filament-mails-config"
```

Optionally, you can publish the views using

```
php artisan vendor:publish --tag="filament-mails-views"
```

Add the routes to the PanelProvider using the `routes()` method, like this:

```
use Backstage\FilamentMails\Facades\FilamentMails;

public function panel(Panel $panel): Panel
{
    return $panel
        ->routes(fn () => FilamentMails::routes());
}
```

Then add the plugin to your `PanelProvider`

```
use Backstage\FilamentMails\FilamentMailsPlugin;

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

### Tenant middleware and route protection

[](#tenant-middleware-and-route-protection)

If you want to protect the mail routes with your (tenant) middleware, you can do so by adding the routes to the `tenantRoutes`:

```
use Backstage\FilamentMails\FilamentMailsPlugin;
use Backstage\FilamentMails\Facades\FilamentMails;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(FilamentMailsPlugin::make())
        ->tenantRoutes(fn() => FilamentMails::routes());
}
```

Important

For setting up the webhooks to register mail events, please look into the README of [Laravel Mails](https://github.com/backstagephp/laravel-mails), the underlying package that powers this package.

### Configuration

[](#configuration)

Sometimes you want to customize the resource, like configuring which users or roles may access the resource. You can do this by overriding the `MailResource` or `EventResource` classes in the `filament-mails` config file. Make sure your custom resource extends the original resource.

```
return [
    'resources' => [
        'mail' => \App\Filament\Resources\MailResource::class,
        'event' => \App\Filament\Resources\EventResource::class,
        'suppression' => \App\Filament\Resources\SuppressionResource::class
    ],
];
```

Features and screenshots
------------------------

[](#features-and-screenshots)

### List with all sent emails and statistics

[](#list-with-all-sent-emails-and-statistics)

The package provides a clear overview of all emails, including statistics and the ability to filter the data. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mails-list.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mails-list.png)

### Resending emails

[](#resending-emails)

You can resend emails to the same or another recipient(s). This is useful when your email has bounced and you want to resend it. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-resend.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-resend.png)

### Information

[](#information)

You can view all relevant information about the email, such as the subject, the body, the attachments, the from address, the to address(es), the cc address(es), the bcc address(es), the reply to address, metadata and much more. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-sender-information.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-sender-information.png)[![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-statistics.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-statistics.png)[![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-events.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-events.png)[![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-attachments.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-attachments.png)

### Preview email

[](#preview-email)

The package provides a preview of the email. This is useful to quickly check if the email is correct. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-preview.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-preview.png)

We also provide the raw HTML and plain text of the email. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-raw-html.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/mail-raw-html.png)

### Events

[](#events)

The package also logs all events that are fired when an email is sent. This is useful to track the email sending process. [![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/events-list.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/events-list.png)[![Filament Mails](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/event-details.png)](https://raw.githubusercontent.com/backstagephp/filament-mails/main/docs/event-details.png)

Testing
-------

[](#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)

- [Baspa](https://github.com/backstagephp)
- [Mark van Eijk](https://github.com/markvaneijk)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance62

Regular maintenance activity

Popularity7

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68% 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 ~14 days

Total

6

Last Release

236d ago

PHP version history (2 changes)0.0.1PHP ^8.1

0.0.4PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/02c87326bfe0283475a9bd73a12100d564617668fd9fd57eb703ea08f420898e?d=identicon)[DanielHe4rt](/maintainers/DanielHe4rt)

---

Top Contributors

[![Baspa](https://avatars.githubusercontent.com/u/10845460?v=4)](https://github.com/Baspa "Baspa (200 commits)")[![markvaneijk](https://avatars.githubusercontent.com/u/1925388?v=4)](https://github.com/markvaneijk "markvaneijk (59 commits)")[![mhortulanus](https://avatars.githubusercontent.com/u/91618246?v=4)](https://github.com/mhortulanus "mhortulanus (15 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![Skullbock](https://avatars.githubusercontent.com/u/1104083?v=4)](https://github.com/Skullbock "Skullbock (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![cntabana](https://avatars.githubusercontent.com/u/6320126?v=4)](https://github.com/cntabana "cntabana (2 commits)")[![danielhe4rt](https://avatars.githubusercontent.com/u/6912596?v=4)](https://github.com/danielhe4rt "danielhe4rt (2 commits)")[![vincentvankekerix](https://avatars.githubusercontent.com/u/32239111?v=4)](https://github.com/vincentvankekerix "vincentvankekerix (1 commits)")[![bariskanberkay](https://avatars.githubusercontent.com/u/48731845?v=4)](https://github.com/bariskanberkay "bariskanberkay (1 commits)")[![iAmKevinMcKee](https://avatars.githubusercontent.com/u/4503765?v=4)](https://github.com/iAmKevinMcKee "iAmKevinMcKee (1 commits)")[![atmonshi](https://avatars.githubusercontent.com/u/1952412?v=4)](https://github.com/atmonshi "atmonshi (1 commits)")

---

Tags

laravelfilament-mailsbackstage

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/danielhe4rt-filament-mails/health.svg)

```
[![Health](https://phpackages.com/badges/danielhe4rt-filament-mails/health.svg)](https://phpackages.com/packages/danielhe4rt-filament-mails)
```

###  Alternatives

[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

246177.6k7](/packages/awcodes-filament-quick-create)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[ralphjsmit/laravel-filament-seo

A package to combine the power of Laravel SEO and Filament Admin.

15398.7k10](/packages/ralphjsmit-laravel-filament-seo)[geo-sot/filament-env-editor

Access .env file though Filament admin panel

2432.3k1](/packages/geo-sot-filament-env-editor)[inerba/filament-db-config

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

329.1k](/packages/inerba-filament-db-config)[caresome/filament-neobrutalism-theme

A neobrutalism theme for FilamentPHP admin panels

303.2k](/packages/caresome-filament-neobrutalism-theme)

PHPackages © 2026

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