`useHead`

The useHead composable function allows you to manage your head tags in a programmatic and reactive way, powered by Unhead. If the data comes from a user or other untrusted source, we recommend you check out useHeadSafe

👉

Read more in Docs > Getting Started > Seo Meta.

Type

useHead(meta: MaybeComputedRef<MetaObject>): void

Below are the non-reactive types for useHead.

interface MetaObject {
  title?: string
  titleTemplate?: string | ((title?: string) => string)
  base?: Base
  link?: Link[]
  meta?: Meta[]
  style?: Style[]
  script?: Script[]
  noscript?: Noscript[]
  htmlAttrs?: HtmlAttributes
  bodyAttrs?: BodyAttributes
}

See @unhead/schema for more detailed types.

The properties of useHead can be dynamic, accepting ref, computed and reactive properties. meta parameter can also accept a function returning an object to make the entire object reactive.

Parameters

`meta`

Type: MetaObject

An object accepting the following head metadata:

meta
Type: Array<Record<string, any>>
Each element in the array is mapped to a newly-created <meta> tag, where object properties are mapped to the corresponding attributes.
link
Type: Array<Record<string, any>>
Each element in the array is mapped to a newly-created <link> tag, where object properties are mapped to the corresponding attributes.
style
Type: Array<Record<string, any>>
Each element in the array is mapped to a newly-created <style> tag, where object properties are mapped to the corresponding attributes.
script
Type: Array<Record<string, any>>
Each element in the array is mapped to a newly-created <script> tag, where object properties are mapped to the corresponding attributes.
noscript
Type: Array<Record<string, any>>
Each element in the array is mapped to a newly-created <noscript> tag, where object properties are mapped to the corresponding attributes.
titleTemplate
Type: string | ((title: string) => string)
Configures dynamic template to customize the page title on an individual page.
title
Type: string
Sets static page title on an individual page.
bodyAttrs
Type: Record<string, any>
Sets attributes of the <body> tag. Each object property is mapped to the corresponding attribute.
htmlAttrs
Type: Record<string, any>
Sets attributes of the <html> tag. Each object property is mapped to the corresponding attribute.

Edit on Github