monteiro/telescope-mail-attachments

Mail attachment support for Laravel Telescope

0.3.0 2026-02-25 17:58 UTC

Requires

• php: ^8.1
• laravel/telescope: ^5.0

Requires (Dev)

• laravel/pint: ^1.14
• orchestra/testbench: ^9.0||^10.0
• pestphp/pest: ^3.0||^4.0
• pestphp/pest-plugin-laravel: ^3.0||^4.0
• phpstan/phpstan: ^2.0

MIT

• Hugo Monteiro

• mail
• laravel
• attachments
• telescope
• monteiro

README

Mail attachment support for Laravel Telescope. Captures email attachments (filename, size, MIME type, content) during mail recording, stores them in Telescope entries, and provides download endpoints + UI.

Installation

composer require monteiro/telescope-mail-attachments

Configuration

In your config/telescope.php, replace MailWatcher with MailAttachmentWatcher:

'watchers' => [
    // Laravel\Telescope\Watchers\MailWatcher::class => env('TELESCOPE_MAIL_WATCHER', true),
    Monteiro\TelescopeMailAttachments\MailAttachmentWatcher::class => env('TELESCOPE_MAIL_WATCHER', true),
    // ... other watchers
],

Optionally publish the config file:

php artisan vendor:publish --tag=telescope-mail-attachments-config

Config Options

Option	Default	Description
store_content	true	Store base64-encoded attachment content. Set to false to only store metadata (filename, size, MIME type) and reduce storage usage.

You can also set TELESCOPE_MAIL_ATTACHMENTS_STORE_CONTENT=false in your .env.

Features

• Paperclip badge with attachment count on the mail index page
• Attachments table with download links on the mail preview page
• Download endpoint for individual attachments
• Optional content storage toggle to manage database size

Screenshot

Testing

composer test

License

The MIT License (MIT). Please see License File for more information.