Welcome to the documentation for ArtisanPack UI SEO, a comprehensive Laravel SEO management package. This package provides everything you need to optimize your Laravel application for search engines, including meta tag management, social media optimization, structured data, URL redirects, XML sitemaps, and more.
Table of Contents
-
Getting Started
-
Installation
-
Usage
-
Components
-
API Reference
-
Advanced
-
Upgrade Guides
Features
- Meta Tag Management - Automatically generate or manually customize meta titles and descriptions for any Eloquent model
- Social Media Optimization - Full support for Open Graph (Facebook, LinkedIn), Twitter Cards, Pinterest, and Slack
- Schema.org / JSON-LD - 14 built-in schema types with customizable JSON-LD output and a Schema Type Definitions API for dynamic form rendering
- URL Redirects - Manage 301/302/307/308 redirects with exact, regex, and wildcard matching
- XML Sitemaps - Generate standard, image, video, and news sitemaps with automatic sitemap index
- Dynamic Robots.txt - Configure robots.txt with bot-specific rules and automatic sitemap inclusion
- Multi-language Support - Hreflang tag management for international SEO
- SEO Analysis - Built-in content analysis with 8 analyzers for SEO scoring
- AI Feature Suite (v1.2.0) - Five AI agents for meta title/description generation, content quality scoring, JSON-LD schema suggestion, and hreflang gap analysis — all with Livewire, React, and Vue trigger components. Requires the optional
artisanpack-ui/aipackage (PHP 8.3+, Laravel 12+). See AI Features. - Livewire Components - Pre-built admin UI components for managing all SEO features
- Blade Components - Simple view components for rendering SEO tags in your templates
- React & Vue Components - Publishable frontend components for React and Vue via the
seo:install-frontendcommand - Caching - Comprehensive caching system for optimal performance
- Media Library Integration - Seamless integration with ArtisanPack UI Media Library for social images
- Filter Hooks (v1.3.0) - Mutate meta tags and sitemap entries before rendering via the
ap.seo.metaTagsandap.seo.sitemapEntriesfilters. See Filter Hooks.
Quick Example
// Add SEO capabilities to any model
use ArtisanPackUI\Seo\Traits\HasSeo;
class Post extends Model
{
use HasSeo;
}
// Update SEO data
$post->updateSeoMeta([
'meta_title' => 'My Amazing Post',
'meta_description' => 'Learn about amazing things in this post.',
'og_title' => 'My Amazing Post on Social',
'schema_type' => 'Article',
]);
{{-- Render all SEO tags in your layout --}}
<head>
<x-seo-meta :model="$post" />
</head>
Requirements
- PHP 8.2 or higher
- Laravel 10, 11, 12, or 13
- Livewire 3.x (for admin components)
Support
For bugs and feature requests, please open an issue on GitLab.
License
ArtisanPack UI SEO is open-sourced software licensed under the MIT license.