Layup emits standard meta tags (Open Graph, Twitter Cards, canonical, JSON-LD) on every published page. This page covers the integration point, what's emitted, and the per-page and site-wide knobs you can tune. ## Philosophy Layup is a page builder, not an SEO tool. We emit well-formed meta tags from data your editors already provide — title, description, featured image, parent chain, publish date. We deliberately do not ship keyword analysis, content scoring, SERP previews, or any of the things a dedicated SEO tool does well. If you need that, reach for one of those tools. ## The integration point: `` Drop one line into your layout's ``: ```blade {{ $title ?? config('app.name') }} {{-- Your site-wide defaults go here. --}} {{-- Layup adds page-specific overrides on layup-rendered routes and emits nothing on every other route. --}} {{ $slot }} ``` That's it. The component: - **Resolves the page automatically.** When a request goes through Layup's controller (the bundled one or your own subclass of `AbstractController`), the page is shared into view scope as `layupPage`. The component picks it up. - **No-ops on non-layup routes.** Outside a Layup request, the component renders nothing. Safe to leave in a shared layout used by both Layup pages and other parts of your app. - **Doesn't stomp your defaults.** Layup's tags emit *after* whatever you put above them. Where they overlap (e.g., `og:image`), the page-specific value takes precedence — and on non-layup pages, your site-wide defaults are the only ones that render. ## What gets emitted For every published page, the component emits: | Tag | Source | |-----|--------| | `` | `meta.description` (omitted when empty) | | `` | `Page::getMetaTitle()` (page title + optional site suffix) | | `` | `meta.description` (omitted when empty) | | `` | `article` when `published_at` is set, else `website` | | `` | `Page::getUrl()` | | `` | `app()->getLocale()` | | `` | `layup.seo.site_name` (or `app.name`) | | `` | featured image, or `layup.seo.default_og_image` | | `` | `summary_large_image` when an image is present, else `summary` | | `` | `getMetaTitle()` | | `` | `meta.description` (omitted when empty) | | `` | featured image | | `` | `published_at` | | `` | `updated_at` | | `` | `Page::getUrl()` | | `` | `noindex,nofollow` when `meta.noindex` is true | | JSON-LD | `WebPage` / `Article` / `FAQPage` plus `BreadcrumbList` | ## Per-page settings Editors set the following from the **Page Settings** modal: - **Meta Description** — the main `description` value. Reused by OG and Twitter. - **Featured Image** — the OG / Twitter card image. - **Hide from search engines** — adds `noindex,nofollow`. Useful for unlisted landing pages or anything you don't want crawled. - **Publish at** — surfaces as `article:published_time`. The page record's `updated_at` becomes `article:modified_time` automatically. ## Site-wide configuration ```php // config/layup.php 'seo' => [ // Appended to every page's , e.g. ' – Site Name'. 'title_suffix' => null, // og:site_name fallback. Falls through to config('app.name') when null. 'site_name' => null, // Path or URL used when a page has no featured image. // Path is resolved through layup.uploads.disk; absolute URLs pass through. 'default_og_image' => null, // Label for the root crumb in BreadcrumbList JSON-LD. 'home_breadcrumb_label' => 'Home', ], ``` ## Custom controllers If your controller extends `Crumbls\Layup\Http\Controllers\AbstractController`, the page is shared into view scope automatically and `<x-layup-seo />` works with no further wiring. If you have a fully custom controller that doesn't extend `AbstractController`, pass the page in explicitly: ```blade <x-layup-seo :page="$myPage" /> ``` You can also use this form to render meta for a different page than the one currently being rendered (e.g., previews, embeds). ## Disabling Layup's frontend `config('layup.frontend.enabled') = false` only disables Layup's auto-registered routes. Custom controllers extending `AbstractController` still render Layup pages and still share `layupPage` into view scope. If you want to bypass Layup's controller entirely, route to your own controller and don't extend `AbstractController`. ## Structured data `Page::getStructuredData()` returns the JSON-LD documents the component emits. The first is the page schema, controlled by `meta.schema_type`: - `WebPage` (default) - `Article` / `BlogPosting` — picks up `meta.author` - `FAQPage` — auto-detects accordion / toggle widgets and emits `Question` / `Answer` entries The second document is `BreadcrumbList`. When the page has a parent chain (`parent_id`), the breadcrumbs walk that chain and use real page titles. For legacy pages whose slug contains slashes but has no `parent_id`, breadcrumbs fall back to splitting the URL path with title-cased segments — the leaf crumb still uses the page's actual title. ## Customizing what gets emitted If you need different tags, the simplest path is to skip the component and call the model methods directly in your own meta block: ```blade @isset($layupPage) <meta name="description" content="{{ $layupPage->getMetaDescription() }}"> <meta property="og:title" content="{{ $layupPage->getMetaTitle() }}"> {{-- ...your own subset, in whatever order you like... --}} @endisset ``` `$layupPage` is the same view-shared variable the component uses internally, so this works in any layout that's rendered through `AbstractController`. ## Sitemap Layup does not generate `sitemap.xml` for you, but `Page::sitemapEntries()` returns the URL / `lastmod` / priority data you need to build one with the package of your choice (e.g. `spatie/laravel-sitemap`). --- ## Documentation - [Introduction](https://documentation.crumbls.com/layup/-/index.md) - [Introduction](https://documentation.crumbls.com/layup/-/introduction.md) - [v1](https://documentation.crumbls.com/layup/-/_index.md) - [Installation](https://documentation.crumbls.com/layup/-/installation.md) - [Contributing to Layup](https://documentation.crumbls.com/layup/-/CONTRIBUTING.md) - [Usage](https://documentation.crumbls.com/layup/-/usage.md) - [Configuration](https://documentation.crumbls.com/layup/-/configuration.md) - [Examples](https://documentation.crumbls.com/layup/-/examples.md) - [Grid System](https://documentation.crumbls.com/layup/-/grid-system.md) - [Field-only Installation](https://documentation.crumbls.com/layup/-/field-only-installation.md) - [Embedding the Field](https://documentation.crumbls.com/layup/-/embedding-the-field.md) - [Widgets](https://documentation.crumbls.com/layup/-/widgets/_index.md) - [Getting Started](https://documentation.crumbls.com/layup/-/getting-started/_index.md) - [Customization](https://documentation.crumbls.com/layup/-/customization/_index.md) - [API Reference](https://documentation.crumbls.com/layup/-/api-reference/_index.md) - [Upgrade guide](https://documentation.crumbls.com/layup/-/upgrade-guide.md) - [Troubleshooting](https://documentation.crumbls.com/layup/-/troubleshooting.md) - [Changelog](https://documentation.crumbls.com/layup/-/CHANGELOG.md) - [🔐 Security Policy](https://documentation.crumbls.com/layup/-/SECURITY.md) - [The MIT License (MIT)](https://documentation.crumbls.com/layup/-/LICENSE.md) - [Layup Widget Development Guide for AI Agents](https://documentation.crumbls.com/layup/-/AGENTS.md) - [Layup — Sprint TODO (overnight Feb 23-24)](https://documentation.crumbls.com/layup/-/TODO.md) - [Vision](https://documentation.crumbls.com/layup/-/VISION.md) - [Content Widgets](https://documentation.crumbls.com/layup/-/widgets/content.md) - [Media Widgets](https://documentation.crumbls.com/layup/-/widgets/media.md) - [Interactive Widgets](https://documentation.crumbls.com/layup/-/widgets/interactive.md) - [Layout Widgets](https://documentation.crumbls.com/layup/-/widgets/layout.md) - [Advanced Widgets](https://documentation.crumbls.com/layup/-/widgets/advanced.md) - [Creating Pages](https://documentation.crumbls.com/layup/-/getting-started/creating-pages.md) - [Adding Widgets](https://documentation.crumbls.com/layup/-/getting-started/adding-widgets.md) - [Saving and Publishing](https://documentation.crumbls.com/layup/-/getting-started/publishing.md) - [Disable the Pages Resource](https://documentation.crumbls.com/layup/-/customization/disable-pages-resource.md) - [Rendering Content](https://documentation.crumbls.com/layup/-/customization/rendering-content.md) - [Frontend Rendering](https://documentation.crumbls.com/layup/-/customization/frontend-rendering.md) - [Creating Custom Widgets](https://documentation.crumbls.com/layup/-/customization/custom-widgets.md) - [Extending Existing Widgets](https://documentation.crumbls.com/layup/-/customization/extending-widgets.md) - [Livewire-rendered widgets](https://documentation.crumbls.com/layup/-/customization/livewire-widgets.md) - [Filament Plugin API](https://documentation.crumbls.com/layup/-/customization/filament-plugin-api.md) - [Theme System](https://documentation.crumbls.com/layup/-/customization/theme-system.md) - [Tailwind Safelist](https://documentation.crumbls.com/layup/-/customization/tailwind-safelist.md) - [Page Templates](https://documentation.crumbls.com/layup/-/customization/page-templates.md) - [Revision History](https://documentation.crumbls.com/layup/-/customization/revision-history.md) - [Swapping the Page Model](https://documentation.crumbls.com/layup/-/customization/swapping-the-page-model.md) - [Testing](https://documentation.crumbls.com/layup/-/customization/testing.md) - [Widget Contract](https://documentation.crumbls.com/layup/-/api-reference/widget-contract.md) - [Models](https://documentation.crumbls.com/layup/-/api-reference/models.md) - [Service Provider](https://documentation.crumbls.com/layup/-/api-reference/service-provider.md) - [Support Classes](https://documentation.crumbls.com/layup/-/api-reference/support-classes.md) - [Commands](https://documentation.crumbls.com/layup/-/api-reference/commands.md)