> For AI agents: the complete documentation index is available at https://rspress.rs/llms.txt, the full documentation bundle is available at https://rspress.rs/llms-full.txt.

# useHead

`useHead` lets you declare document head tags from React components or custom layouts.

- **Type:** `(input: UseHeadInput) => ActiveHeadEntry | void`

Rspress re-exports this hook from `@rspress/core/runtime`, so you can use the same head API in custom pages, theme components, and layout code.

```tsx
import { useHead } from '@rspress/core/runtime';

export function ProductMeta() {
  useHead({
    title: 'Rspress',
    meta: [
      {
        name: 'description',
        content: 'Static site generator based on Rsbuild and MDX.',
      },
      {
        property: 'og:title',
        content: 'Rspress',
      },
    ],
    link: [
      {
        rel: 'canonical',
        href: 'https://rspress.dev/',
      },
    ],
  });

  return null;
}
```

Use `useHead` when your head data is easier to build from JavaScript objects or depends on component state and props.

> If you prefer authoring tags directly in MDX, use the [`Head`](https://rspress.rs/ui/runtime-components/head.md) component instead.