marcogermani87/filament-captcha

Easy Captcha image integrations for Filament

v2.2.0 2026-01-21 20:57 UTC

Requires

• php: ^8.2
• ext-gd: *
• filament/filament: ^4.0|^5.0
• gregwar/captcha: ^1.2
• illuminate/contracts: ^11.0|^12.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.0|^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^7.9|^8.0
• orchestra/testbench: ^8.0|^9.0|^10.0
• pestphp/pest: ^2.0|^3.7
• pestphp/pest-plugin-arch: ^2.0|^3.0
• pestphp/pest-plugin-laravel: ^2.0|^3.1
• pestphp/pest-plugin-livewire: ^2.1|^3.0

MIT

• Marco Germani

• php
• captcha
• laravel
• filament
• marcogermani87

README

A package to easily include captcha field into Filament forms.

This plugin is based on Gregwar/Captcha package.

Version Compatibility

Plugin	Filament	Laravel	PHP
1.x	3.x	10.x	8.x
1.x	3.x	11.x | 12.x	8.2 | 8.3 | 8.4
2.x	4.x | 5.x	11.x | 12.x	8.2 | 8.3 | 8.4

Installation

You can install the package via composer:

composer require marcogermani87/filament-captcha

You can publish the config file with:

php artisan vendor:publish --tag="filament-captcha-config"

This is the contents of the published config file:

<?php

use Filament\Support\Enums\Size;

return [

    // optional, default is 5
    // 'length' => 4,

    // optional, default is 'abcdefghijklmnpqrstuvwxyz123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
    // 'charset' => '123456789',

    'width' => 180,

    'height' => 50,

    'background_color' => [255, 255, 255],

    'refresh_button' => [
        'icon' => 'heroicon-o-arrow-path',
        'size' => Size::Medium,
    ]

];

Usage

Register the plugin through your panel service provider:

->plugin(\MarcoGermani87\FilamentCaptcha\FilamentCaptcha::make())

You can include the captcha field like any other filament field.

<?php

use MarcoGermani87\FilamentCookieConsent\Components\CaptchaField;

public function form(Schema $schema): Schema
{
    return $schema
        ->components([
            ...
            CaptchaField::make('captcha'),
        ]);
}

Screenshots

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Marco Germani
• All Contributors

License

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