# SEO by Joost de Valk

> SEO plugin for EmDash CMS — meta tags, Open Graph, canonical URLs, robots directives, and JSON-LD schema markup.

Source: https://emdashcmseverything.com/plugins/jdevalk-seo/

- Category: SEO
- Status: available
- Version: 0.12.0
- Price: Unknown
- Compatibility: emdash >= 0.5.0
- License: MIT
- Maintainer: Joost de Valk
- Download: https://www.npmjs.com/package/@jdevalk/emdash-plugin-seo
- Repository: https://github.com/jdevalk/emdash-plugin-seo
- Published: 2026-04-06

The most comprehensive SEO plugin for EmDash CMS, built by Joost de Valk. It generates meta tags, Open Graph, Twitter Cards, canonical URLs, robots directives, and JSON-LD schema markup via the `page:metadata` hook.

## Features

- **Meta descriptions** with configurable fallback chain
- **Meta robots** with `max-snippet`, `max-image-preview`, and `max-video-preview` directives
- **Canonical URLs** — absolute, normalized, with trailing slash and pagination support
- **Open Graph** — `og:title` without site name suffix, full set of OG tags
- **Twitter Cards** — `summary_large_image` when image present, site handle from settings
- **Breadcrumbs** — derived from URL path with segment label overrides
- **JSON-LD** schema markup with Person or Organization support
- **llms.txt** generation (experimental)

## Installation

```bash
npm install @jdevalk/emdash-plugin-seo
```

Register it in your Astro config:

```typescript
import { seoPlugin } from "@jdevalk/emdash-plugin-seo";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [seoPlugin()],
    }),
  ],
});
```

## Configuration

Configure settings in the EmDash admin panel including site name, title separator, default meta description, person/organization schema, social profiles, and breadcrumb segment overrides.

## Operational tips

- Requires `emdash@^0.5.0` for `ContentItem.slug`/`status`/`locale` fields.
- Pin the plugin version during critical campaigns to avoid unexpected behavior changes.
- Review generated JSON-LD in Google's Rich Results Test before launch.
