Installation

npm install @casoon/astro-structured-data

pnpm add @casoon/astro-structured-data

yarn add @casoon/astro-structured-data

Register the integration

// astro.config.mjs
import { defineConfig } from 'astro/config';
import structuredData from '@casoon/astro-structured-data';

export default defineConfig({
  site: 'https://example.com', // used automatically by the integration
  integrations: [
    structuredData({
      generateMeta: true,
      siteName: 'My Awesome Website',
      locale: 'de_DE',
      twitterSite: '@mywebsite',
    }),
  ],
});

The integration needs an absolute base URL to build canonical URLs, mainEntityOfPage and breadcrumb items. It takes Astro’s site; without it, pass siteUrl:

structuredData({ siteUrl: 'https://example.com' })

Requirements

The runtime dependencies are zod and schema-dts (types only). The components add no client JavaScript to your pages; the Dev Toolbar panel exists only in astro dev.

Next steps

Continue with the Quickstart to put a first schema on a page.