2022-10-06 09:15:30 +00:00
---
2022-10-12 17:00:17 +00:00
description: useHead customizes the head properties of individual pages of your Nuxt app.
2022-10-06 09:15:30 +00:00
---
2023-07-07 16:24:09 +00:00
# useHead
2022-04-06 05:56:08 +00:00
2023-09-03 15:37:22 +00:00
The [`useHead` ](/docs/api/composables/use-head ) composable function allows you to manage your head tags in a programmatic and reactive way, powered by [Unhead ](https://unhead.unjs.io/ ). If the data comes from a user or other untrusted source, we recommend you check out [`useHeadSafe` ](/docs/api/composables/use-head-safe )
2022-04-11 21:00:43 +00:00
2023-03-14 14:24:41 +00:00
:ReadMore{link="/docs/getting-started/seo-meta"}
2022-10-12 17:00:17 +00:00
2022-09-03 10:57:21 +00:00
## Type
2022-04-11 21:00:43 +00:00
2022-09-03 10:57:21 +00:00
```ts
2022-10-12 17:00:17 +00:00
useHead(meta: MaybeComputedRef< MetaObject > ): void
```
2023-07-07 16:24:09 +00:00
Below are the non-reactive types for [`useHead` ](/docs/api/composables/use-head ) .
2022-10-12 17:00:17 +00:00
```ts
interface MetaObject {
2022-09-03 10:57:21 +00:00
title?: string
2022-10-12 17:00:17 +00:00
titleTemplate?: string | ((title?: string) => string)
base?: Base
link?: Link[]
meta?: Meta[]
style?: Style[]
script?: Script[]
noscript?: Noscript[]
htmlAttrs?: HtmlAttributes
bodyAttrs?: BodyAttributes
2022-09-03 10:57:21 +00:00
}
2022-04-11 21:00:43 +00:00
```
2023-03-08 15:32:24 +00:00
See [@unhead/schema ](https://github.com/unjs/unhead/blob/main/packages/schema/src/schema.ts ) for more detailed types.
2022-09-03 10:57:21 +00:00
::alert{type=info}
2023-07-07 16:24:09 +00:00
The properties of [`useHead` ](/docs/api/composables/use-head ) 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.
2022-04-06 05:56:08 +00:00
::
2022-04-11 21:00:43 +00:00
2022-09-03 10:57:21 +00:00
## 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.
