Laravel Shortcodes — Filament Plugin

Manage Laravel Shortcodes directly from your Filament admin panel.

A Filament v3 plugin for webwizo/laravel-shortcodes that lets content editors create, manage, and use shortcodes without touching PHP code.

Create reusable static or dynamic shortcodes, define attributes, build HTML templates, connect shortcodes to live database records, and scope everything to your Filament tenants.

• 🧩 Shortcode Management — Create, edit, and delete shortcodes from Filament
• 🎨 Template Builder — Define HTML output using simple placeholders
• ⚡ Dynamic Data Sources — Pull live records from your database
• 🏷️ Custom Attributes — Define reusable shortcode attributes with defaults
• 🏢 Multi-Tenancy — Scope shortcodes to individual Filament tenants
• 💻 IDE Autocomplete — Annotated facade for PhpStorm, VS Code & Intelephense
• 🔌 Zero Boilerplate — Automatic shortcode registration

Built on top of the battle-tested webwizo/laravel-shortcodes package.

• Full CRUD UI — list, create, edit, and delete shortcodes from the Filament panel
• Shortcode types — choose between Static (attributes + template only) and Dynamic (adds a live DB data source)
• Attribute builder — define named attributes with defaults via a repeater UI
• HTML template editor — write the output HTML with {{attr}}, {{content}}, and {{db.column}} placeholders
• Dynamic data sources — pull a live database row into any shortcode template at render time, with soft-delete awareness
• Usage example — auto-generated, copyable shortcode string shown in the table and edit form
• Annotated Facade — full IDE autocompletion for compile(), strip(), and more via Webwizo\ShortcodesFilament\Facades\Shortcode
• Multi-tenancy — first-class Filament multi-tenant support with auto-detection of int, UUID, and ULID primary keys
• Zero boilerplate — shortcodes register themselves automatically on boot; no manual Shortcode::register() calls needed

Install the package via Composer:

composer require webwizo/laravel-shortcodes-filament

Publish the config and migration:

php artisan vendor:publish --tag=shortcodes-filament-config
php artisan vendor:publish --tag=shortcodes-filament-migrations
php artisan migrate

Register the plugin in your Filament panel provider:

use Webwizo\ShortcodesFilament\ShortcodesFilamentPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ShortcodesFilamentPlugin::make(),
        ]);
}

Once a shortcode is created in the panel, editors can embed it anywhere:

[store id="5"]Buy now[/store]

[hero class="dark" title="Welcome"]Homepage banner[/hero]

To render shortcodes in a Blade view, use the webwizo/laravel-shortcodes parser:

{!! Shortcode::compile($post->content) !!}

For full IDE autocompletion (compile, strip, register, etc.), import the facade provided by this package instead of the vendor one:

use Webwizo\ShortcodesFilament\Facades\Shortcode;

// compile() now autocompletes in PhpStorm, VS Code + Intelephense, etc.
return Shortcode::compile($post->content);

1. Navigate to Content → Shortcodes in the sidebar
2. Click New Shortcode
3. Fill in:
   • Tag — the shortcode name used in content, e.g. store (lowercase, hyphens allowed)
   • Label — human-readable name shown in the panel
   • Type — Static for pure HTML/attribute templates, Dynamic to attach a live DB data source
   • Attributes — named parameters editors can pass, each with an optional default value
   • Dynamic Data Source (Dynamic type only) — pick the table, lookup column, and which shortcode attribute holds the lookup value
   • Template — the HTML output, using placeholders described below
4. Save — the shortcode is immediately live

Example template:

<div class="store-card {{class}}">
    <h2>{{db.name}}</h2>
    <p>{{db.description}}</p>
    {{content}}
</div>

Used in content as:

[store id="5" class="featured"]Check it out[/store]

Every shortcode has a Type:

• Static — renders the HTML template with attribute and content substitution only. The Dynamic Data Source section is hidden.
• Dynamic — additionally pulls a live row from a database table at render time, making {{db.column_name}} placeholders available in the template.

Set the shortcode type to Dynamic and fill in the Dynamic Data Source section:

• Database Table — the table to query
• Lookup Column — the column used to find the row (e.g. id)
• Shortcode Attribute — which shortcode attribute holds the lookup value (e.g. id)

Then reference any column from that row in your template with {{db.column_name}}.

<div class="store-card {{class}}">
    <strong>{{db.name}}</strong>
    <span>{{db.slug}}</span>
    {{content}}
</div>

Used in content as:

[store id="01kre0dee551yx52r6jwdambg6" class="featured"]Check it out[/store]

Validation behaviour:

• If the lookup attribute is missing from the tag (e.g. [store]), the shortcode renders nothing.
• If the lookup value does not match any row, the shortcode renders nothing.
• Soft-deleted rows (deleted_at IS NOT NULL) are automatically excluded.
• Any {{db.*}} placeholders with no matching column are silently removed.

Results are cached for 600 seconds by default (configurable via cache_ttl).

After publishing, edit config/shortcodes-filament.php:

return [

    // Eloquent model used for shortcodes. Swap this to extend with your own model.
    'model' => \Webwizo\ShortcodesFilament\Models\Shortcode::class,

    // Database table name
    'table_name' => 'shortcodes',

    // Tables hidden from the Dynamic Data Source picker
    'excluded_tables' => [
        'migrations', 'failed_jobs', 'sessions', 'cache', /* ... */
    ],

    // Cache TTL in seconds for dynamic data source results. Set 0 to disable.
    'cache_ttl' => 600,

    'tenant' => [
        // Foreign key column on the shortcodes table
        'foreign_key'  => 'team_id',

        // Relationship method name on the Shortcode model
        'relationship' => 'team',

        // Your tenant Eloquent model class
        'model'        => \App\Models\Team::class,

        // Primary-key type: 'int', 'uuid', 'ulid', 'string', or null to auto-detect
        'key_type'     => null,
    ],

];

All options can also be set inline in the panel provider, which takes precedence over the config file:

ShortcodesFilamentPlugin::make()
    ->navigationGroup('CMS')
    ->navigationIcon('heroicon-o-code-bracket')
    ->navigationSort(5)
    ->usingDynamicDataSources(true)

If your app does not use Filament's multi-tenant system, simply leave tenant.model as null in the config (the default). The migration will create a clean shortcodes table with no foreign key column, and tags will be unique globally.

'tenant' => [
    'model' => null, // no tenant column created in the migration
],

If you installed the package without multi-tenancy and want to add it later, the original migration has already run so you cannot re-run it. Instead, update your config with the tenant model, foreign key, and relationship, then run the built-in command:

php artisan shortcodes:add-tenant

The command will:

• Read your tenant.model, tenant.foreign_key, and tenant.key_type from config
• Auto-detect the correct column type from your tenant model's traits if key_type is not set
• Check the column does not already exist
• Generate a new migration file in your database/migrations folder

Then apply it:

php artisan migrate

The generated migration adds the FK column, drops the global UNIQUE(tag) index, and replaces it with a tenant-scoped UNIQUE(tenant_fk, tag) so the same tag can exist independently per tenant.

The plugin has first-class support for Filament's multi-tenancy.

Pass your tenant model and relationship details on the plugin:

ShortcodesFilamentPlugin::make()
    ->scopedToTenant(true)
    ->tenantRelationship('team')       // method name on the Shortcode model
    ->tenantForeignKey('team_id')      // FK column on the shortcodes table
    ->tenantModel(\App\Models\Team::class)

The migration automatically uses the right column type for the foreign key based on your tenant model:

Auto-detection is on by default — the migration inspects class_uses_recursive() on your tenant model and picks the right column type. You can override it explicitly:

// Via plugin fluent API
ShortcodesFilamentPlugin::make()
    ->tenantKeyType('ulid')

// Or via config
'tenant' => [
    'key_type' => 'ulid',
],

Filament's tenancy system requires your tenant model to declare a hasMany relationship back to the shortcodes table. Add this to your tenant model:

use Illuminate\Database\Eloquent\Relations\HasMany;
use Webwizo\ShortcodesFilament\Models\Shortcode;

public function shortcodes(): HasMany
{
    return $this->hasMany(Shortcode::class, 'team_id');
}

Replace team_id with whatever foreign key you configured. Without this relationship Filament will throw a "does not have a relationship" error when loading the panel.

1. Tenant model (app/Models/Team.php):

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Webwizo\ShortcodesFilament\Models\Shortcode;

class Team extends Model
{
    // Required: Filament uses this to scope shortcodes to the current tenant
    public function shortcodes(): HasMany
    {
        return $this->hasMany(Shortcode::class, 'team_id');
    }
}

2. Panel provider (app/Providers/Filament/AdminPanelProvider.php):

use App\Models\Team;
use Webwizo\ShortcodesFilament\ShortcodesFilamentPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->tenant(Team::class, slugAttribute: 'slug')
        ->plugins([
            ShortcodesFilamentPlugin::make()
                ->navigationGroup('Content')
                ->scopedToTenant(true)
                ->tenantRelationship('team')
                ->tenantForeignKey('team_id')
                ->tenantModel(Team::class),
        ]);
}

You can swap in your own model by updating the config:

// config/shortcodes-filament.php
'model' => \App\Models\Shortcode::class,

Your model should extend the package model to keep all functionality:

namespace App\Models;

use Webwizo\ShortcodesFilament\Models\Shortcode as BaseShortcode;

class Shortcode extends BaseShortcode
{
    // Add your own methods, casts, relationships, etc.
}

Please see CHANGELOG.md for recent changes.

Pull requests are welcome. For major changes please open an issue first to discuss what you would like to change.

This plugin is open source and built on top of webwizo/laravel-shortcodes.

If this plugin saves you development time or makes managing shortcodes easier for your team, consider supporting its continued development.

Your support helps me:

• 🛠️ Maintain and improve the plugin
• 🐛 Fix bugs and edge cases
• 🚀 Add new Filament and Laravel features
• 📚 Improve documentation and examples
• 🔧 Keep the package compatible with newer versions
• 💡 Build more useful open-source tools for Laravel developers

☕ Support the project →

Even a small contribution helps me spend more time maintaining and improving open-source packages.

You can also support the project without spending anything:

• ⭐ Star the repository
• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit pull requests
• 📖 Improve documentation
• 📣 Share it with other Laravel / Filament developers

Thank you for using the plugin and supporting open source. ❤️

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

• Asif Iqbal
• Built on webwizo/laravel-shortcodes and Filament