Skip to main content
FilaRank 3.0 is crawl control and on-page templates that Rank Math / Yoast treat as table-stakes, without GSC or GA4 OAuth. Existing HasSeo, SeoFields::make(), and SeoScoreColumn::make() calls keep working.
1

Run the upgrade command

That publishes the v3 migration and prints the breaking-change notes. Then:
This adds schema_type, social override columns, and custom_json_ld on seo_metas, is_regex on redirects, plus filarank_robots_revisions, filarank_seo_revisions, and filarank_locations.
2

Point at /sitemap.xml

Change sitemap.path to sitemap.xml if you published the config. /filarank-sitemap.xml 301s to the new path. See XML sitemap.
3

Delete public/robots.txt

A static public/robots.txt is served by the web server and shadows FilaRank’s virtual /robots.txt. Delete it. See robots.txt and llms.txt.
4

HandleRedirects

The middleware is registered on the web stack automatically. Set FILARANK_AUTO_REDIRECTS=false (or redirects.auto_register_middleware) to opt out.If bootstrap/app.php already appends HandleRedirects, remove the duplicate so 404s are not logged twice.
5

Re-diff the config

Publishing the config replaces nested keys such as ai.providers wholesale (mergeConfigFrom merges only top-level keys). Diff rather than overwrite if you customized providers:
New top-level keys: files, indexnow, templates, multilingual, knowledge.
6

Turn on the new pages

Every page still defaults to on. Hide the ones you do not want:

​
What else changed in v3

  • Title templates — empty stored titles render {{title}} {{sep}} {{site}}
  • Social tab — OG/X overrides and Facebook + X previews
  • Bulk SEO — modal editor, CSV, GSC CSV import, IndexNow submit
  • IndexNow — automatic on save, same-host only
  • Schema registry — LocalBusiness, Person, WebPage, Event, HowTo, VideoObject, plus per-record schema_type and custom JSON-LD
  • Knowledge Graph — legal name, logo, sameAs, NAP, geo, per-day opening hours
  • <x-filarank::breadcrumbs />
  • French, German, and Spanish readability packs. Content-language UI stays hidden unless FILARANK_MULTILINGUAL=true
  • Mistral and DeepSeek AI providers
  • Redirects gain regex matching and CSV import/export

​
Coming from v1

v2 added AI, sitemaps, the technical audit, keyword research, rank tracking, backlinks, and competitors. If you are still on v1, run php artisan vendor:publish --tag=filarank-migrations and php artisan migrate so the v2 tables exist before the v3 migration. There are still no breaking API changes on HasSeo / SeoFields / SeoScoreColumn. If you were relying on sitemap.ping_on_save, move to the sitemap.ping toggle. That redundant key was removed in v2.
Last modified on October 10, 2026