Laravel Mail Laravel Package

Campaign reports: with laravel-mail.campaigns.enabled, mail tags (tag() / Envelope tags) are stored on the log (publish and run the new add_tags_to_mail_logs_table migration). CampaignReport and php artisan mail:campaign [tag] report sent, delivered, bounced, complained, distinct opens and clicks, open / click / click-to-open rates and the most clicked links per campaign.

Fix: template text bodies are set on the message directly instead of being passed to text() as a view name.

Full Changelog: https://github.com/jeffersongoncalves/laravel-mail/compare/1.3.0...1.3.1

What's Changed

New Features

• Pixel Tracking (Provider-Independent) — Track email opens and clicks without relying on email provider webhooks. Works with any mailer including plain SMTP.
  • Injects a 1x1 transparent GIF pixel for open tracking
  • Rewrites links for click tracking with 302 redirect
  • HMAC-SHA256 signed URLs to prevent forgery
  • Validates redirect URLs to block unsafe schemes (javascript:, data:, etc.)
  • Coexists with existing webhook-based tracking (events registered with provider=pixel)

New Configuration

LARAVEL_MAIL_PIXEL_OPEN_TRACKING=true
LARAVEL_MAIL_PIXEL_CLICK_TRACKING=true
LARAVEL_MAIL_PIXEL_SIGNING_KEY=  # optional, defaults to APP_KEY

New Files

• Services/PixelTracker — Pixel injection, link rewriting, HMAC signing
• Services/TrackingEventRecorder — Shared event recording service (refactored from AbstractWebhookHandler)
• Http/Controllers/TrackingController — Serves GIF pixel and click redirects
• Listeners/InjectTrackingPixel — MessageSending listener
• routes/tracking.php — Pixel and click routes

Internal Changes

• Added TrackingProvider::Pixel enum case
• Refactored AbstractWebhookHandler to use shared TrackingEventRecorder service
• Updated README, Boost guidelines, and Boost skill documentation

Full Changelog: https://github.com/jeffersongoncalves/laravel-mail/compare/1.2.0...1.3.0

What's New

New Features

• Webhook Idempotency — Duplicate webhook deliveries are detected and ignored via provider_event_id
• MailLog Template ID Association — Emails sent via TemplateMailable automatically link to the template
• Inline CSS — Automatic CSS inlining for email client compatibility (Outlook, Gmail, Yahoo)
• List-Unsubscribe Headers — Gmail/Yahoo compliance with List-Unsubscribe and List-Unsubscribe-Post
• Attachment File Storage — Optionally store email attachment files to disk (S3, local, etc.)
• Per-Status Prune Policies — Different retention periods per status (e.g. delivered=30d, bounced=90d)
• mail:send-test Command — Send test emails using templates via CLI
• mail:templates Command — List all templates in a table
• mail:stats Command — Show email statistics in the terminal
• spatie/laravel-translatable Integration — MailTemplate now uses HasTranslations trait

Bug Fixes

• Removed empty VerifyWebhookSignature middleware (validation already in handlers)
• Webhook/preview controllers return proper 503/404 when features are disabled

Tests

• 148 tests, 346 assertions — all passing
• PHPStan level 5: 0 errors
• New test files for all new features

What's New

New Features

• Tracking Events — Laravel events dispatched on webhook processing: MailDelivered, MailBounced, MailComplained, MailOpened, MailClicked, MailDeferred. Listen to react to delivery status changes (disable accounts on bounce, alert on complaints, etc.)

• Suppression List — Automatically suppress email addresses that hard bounce or receive spam complaints. Suppressed addresses are blocked from future sends. Includes mail:unsuppress command for manual management.

• Statistics — MailStats facade with query helpers: sent(), delivered(), bounced(), complained(), opened(), clicked(), deliveryRate(), bounceRate(), dailyStats().

• Template Preview Action — Render templates with example data without sending: PreviewTemplateAction::execute($template, $data, $locale).

• Browser Preview — View sent emails and templates in the browser via signed URLs. Access via $mailLog->preview_url and $template->preview_url.

• Notification Channel — TemplateMailChannel + TemplateNotificationMailable to send database templates via Laravel Notifications.

• Retry Failed Emails — RetryFailedMailAction with max attempts + mail:retry command. Hard bounces are automatically skipped.

• Laravel Boost Integration — resources/boost/ with guidelines and development skill for AI-assisted development.

Changes

• Pinned Pest 3 for L11/L12 and Pest 4 for L13 in CI matrix

Stats

• 118 tests, 281 assertions
• PHPStan level 5, zero errors
• Laravel 11.x / 12.x / 13.x support

What's New

Initial release of Laravel Mail — complete email management for Laravel.

Features

• Email Logging — Automatic logging of all outgoing emails via MessageSent event
• Database Templates — Store email templates with multi-locale translation and Blade rendering
• Template Versioning — Automatic version history on every content change
• TemplateMailable — Base mailable class that fetches templates from the database with fallback support
• Delivery Tracking — Webhook handlers for 5 providers (SES, SendGrid, Postmark, Mailgun, Resend) with HMAC/signature validation
• Resend Emails — Resend any previously sent email from the log
• Pruning — mail:prune artisan command with configurable retention
• HasMailLogs Trait — Polymorphic association for any model
• Multi-Tenant — Optional tenant scoping for all tables
• Customizable — Override models, table names, and database connection

Requirements

• PHP 8.2+
• Laravel 11.x / 12.x / 13.x