Custom Fields is now open source and can be installed directly via Composer for all users. The installation process is the same whether you’re using the AGPL-3.0 or Commercial license.

​
Requirements

  • PHP: 8.2 or higher
  • Laravel: 10.0 or higher (via Filament)
  • Filament: 3.0 or higher

​
Installation Steps

​
1. Install via Composer

composer require relaticle/custom-fields

​
2. Publish Migrations

php artisan vendor:publish --tag="custom-fields-migrations"

​
3. Run Migrations

php artisan migrate

That’s it! Custom Fields is now installed and ready to use.

​
License Activation (Commercial Users Only)

If you’re using Custom Fields in a closed-source commercial project, you need to purchase and activate a commercial license.

​
License Activation

After purchasing, you’ll receive a license key. Add it to your .env file:

CUSTOM_FIELDS_LICENSE_KEY=your-license-key-here

Or configure it in config/custom-fields.php:

return [
    'license_key' => env('CUSTOM_FIELDS_LICENSE_KEY'),
    // other configuration options...
];

The package will work without a license key, but commercial use without a valid license violates the terms of use. Please ensure you have the appropriate license for your use case.

​
Publishing Assets (Optional)

​
Configuration File

php artisan vendor:publish --tag="custom-fields-config"

​
Language Files

php artisan vendor:publish --tag="custom-fields-translations"

​
Views (for customization)

php artisan vendor:publish --tag="custom-fields-views"

​
Verify Installation

After installation, verify everything is working:

php artisan about

You should see Custom Fields listed in the environment section.

​
License Compliance

​
Troubleshooting

​
Next Steps

Ready to start using Custom Fields? Check out our Quickstart Guide to add your first custom fields in minutes!