Rankbeam SEO

• Installation
• What you get
• Requirements
  • Contributing / local development
• Usage
  • Several languages
• Structured data (optional)
• Testing
  • Testbench note (provider order)
• Translations
• Guides
• License

rankbeam/laravel-seo-filament is the free Laravel SEO package for Filament 4 and 5. Add its complete SEO editor to any resource in two lines. Editors get live Google and social previews, focus keywords, canonical and robots controls, social-image validation, and clear indicators showing whether each value is manual or inherited from Rankbeam's fallback chain.

Free and MIT licensed. Values are stored through rankbeam/laravel-seo, with no extra columns on your resource tables.

Filament guide · Full documentation · Packagist

#Installation

composer require rankbeam/laravel-seo-filament

Installing this package pulls in the core (rankbeam/laravel-seo). If you have not set the core up yet:

php artisan vendor:publish --tag=seo-config
php artisan migrate

#What you get

• Live Google and social previews while editors type.
• Title, description, focus keywords, canonical, robots, and social-image fields.
• Manual-versus-fallback source indicators for every effective value.
• Optional schema.org fields for breadcrumbs, FAQs, and products.
• Filament 4 and 5 support, tested in CI.

#Requirements

Core 2 installs are supported under this constraint: when the newer seoMetaForLocale() helper is not available, the forms hydrate through the older seoMeta() relation.

#Usage

The model behind your resource must use the core HasSEO trait:

use Rankbeam\Seo\Traits\HasSEO;

class Post extends Model
{
    use HasSEO;
}

Then add the section to the resource — two lines:

use Rankbeam\Seo\Filament\Concerns\HasSEOFields;

class PostResource extends Resource
{
    use HasSEOFields;                       // 1

    public static function form(Schema $schema): Schema
    {
        return $schema->components([
            TextInput::make('title'),
            // ...
            static::seoSection(),           // 2
        ]);
    }
}

static::seoSection(['title', 'description']) limits the section to a subset of fields (title, description, focus_keywords, canonical, robots, og_image).

The tabbed Google/social preview is shown by default. Pass showPreview: false to omit it (the source-indicators panel is unaffected):

static::seoSection(showPreview: false);   // or SEOFields::make(showPreview: false)

Without the trait, SEOFields::make() returns the same section directly.

#Several languages

The core keeps one seo_meta row per (model, locale). Pass the locales a page is published in and the section renders one tab per language — each editing its own row, with counters for that language's script (an empty Japanese title shows 0 / 30, an English one 0 / 60), its own preview and its own fallback indicators, badged with the number of fields set:

static::seoSection(locales: ['en', 'it', 'ja']);   // or SEOFields::make(locales: [...])

Or once for every resource, in the published config:

php artisan vendor:publish --tag=seo-filament-config

// config/seo-filament.php
'locales' => ['en', 'it', 'ja'],

Untouched languages never get a placeholder row. When the page runs a translatable plugin (Filament's getActiveSchemaLocale() — the spatie translatable plugins implement it), the section follows the page's own locale switcher instead of showing tabs. With neither, it edits the app locale's row, as before.

Upgrading: the preview view was replaced by the tabbed editor. If you published the package views, refresh or remove the stale copy — see UPGRADING.md.

#Structured data (optional)

Add a second, optional section so editors can attach schema.org JSON-LD without code:

static::seoSchemaSection(),     // or SEOSchemaFields::make()

It writes into the core seo_meta.schema_jsonld column and is pure UI binding over the core schema builders — a one-toggle automatic breadcrumb (BreadcrumbSchema::fromModelAncestors()) plus a repeater of FAQ (FAQSchema) and Product (ProductSchema) blocks. Every built document is validated by the core SchemaValidator; a malformed block (e.g. a Product with no offer) is rejected on save. Schema it can't represent (a hand-authored @graph, an exotic @type, richer Product fields) is preserved verbatim. See the Filament guide for details.

composer update --with "filament/filament:~4.0" && vendor/bin/pest   # Filament 4 leg
composer update --with "filament/filament:~5.0" && vendor/bin/pest   # Filament 5 leg

#Translations

The editor's labels follow app()->getLocale() (the content locales it edits are a separate matter — see Several languages). Publish the strings with php artisan vendor:publish --tag=seo-filament-lang to override a label, or contribute a language — rules and glossary in the core repository's TRANSLATING.md. Seventeen languages ship: English, Italian, German, French, Spanish, Brazilian Portuguese, Dutch, Turkish, Russian, Polish and, since 1.10, Japanese, Simplified and Traditional Chinese (zh_CN, zh_TW), Korean, Greek, Ukrainian and Czech.

#Guides

• Laravel Filament SEO: previews, canonicals and fallback sources
• Laravel SEO: the complete guide
• Best Laravel SEO packages compared

#License

MIT — see LICENSE.md.