2022-10-06 09:15:30 +00:00
---
navigation.icon: uil:file-search-alt
2022-10-12 17:00:17 +00:00
description: Improve your Nuxt app's SEO with powerful head config, composables and components.
2022-10-06 09:15:30 +00:00
---
2022-09-13 12:54:31 +00:00
# SEO and Meta
2021-07-15 11:28:04 +00:00
2022-10-12 17:00:17 +00:00
Improve your Nuxt app's SEO with powerful head config, composables and components.
2022-04-11 09:03:31 +00:00
2022-10-12 17:00:17 +00:00
## App Head
2021-07-15 11:28:04 +00:00
2022-10-12 17:00:17 +00:00
Providing an [app.head ](/api/configuration/nuxt-config#head ) property in your `nuxt.config.ts` allows you to customize the head for your entire app.
2021-07-15 11:28:04 +00:00
2022-10-12 17:00:17 +00:00
::alert{type=info}
This method does not allow you to provide reactive data, if you need global reactive data you can use `useHead` in `app.vue` .
::
2021-10-29 11:26:01 +00:00
2022-10-12 17:00:17 +00:00
Shortcuts are available to make configuration easier: `charset` and `viewport` . You can also provide any other key listed below in [Types ](#types ).
2021-07-15 11:28:04 +00:00
2022-10-12 17:00:17 +00:00
### Defaults
2022-04-06 05:56:08 +00:00
2022-10-12 17:00:17 +00:00
Out-of-the-box, Nuxt provides sane defaults, which you can override if needed.
2022-06-03 15:37:56 +00:00
2022-10-12 17:00:17 +00:00
- `charset` : `utf-8`
- `viewport` : `width=device-width, initial-scale=1`
2022-06-03 15:37:56 +00:00
2022-10-12 17:00:17 +00:00
### Example
2022-06-03 15:37:56 +00:00
2022-10-12 17:00:17 +00:00
```ts{}[nuxt.config.ts]
export default defineNuxtConfig({
app: {
head: {
charset: 'utf-16',
2022-11-16 02:26:35 +00:00
viewport: 'width=500, initial-scale=1',
2022-10-12 17:00:17 +00:00
title: 'My App',
meta: [
// < meta name = "description" content = "My amazing site" >
{ name: 'description', content: 'My amazing site.' }
],
2022-06-03 15:37:56 +00:00
}
2022-10-12 17:00:17 +00:00
}
})
2022-06-03 15:37:56 +00:00
```
2022-10-12 17:00:17 +00:00
:ReadMore{link="/api/configuration/nuxt-config/#head"}
2022-06-03 15:37:56 +00:00
2022-10-12 17:00:17 +00:00
## Composable: `useHead`
2022-08-02 11:43:25 +00:00
2022-10-12 17:00:17 +00:00
The `useHead` composable function allows you to manage your head tags in a programmatic and reactive way, powered by [@vueuse/head ](https://github.com/vueuse/head ).
2022-08-02 11:43:25 +00:00
2022-10-12 17:00:17 +00:00
As with all composables, it can only be used with a components `setup` and lifecycle hooks.
2022-08-02 11:43:25 +00:00
2022-10-12 17:00:17 +00:00
### Example
```vue{}[app.vue]
< script setup lang = "ts" >
2022-08-02 11:43:25 +00:00
useHead({
2022-10-12 17:00:17 +00:00
title: 'My App',
meta: [
{ name: 'description', content: 'My amazing site.' }
],
bodyAttrs: {
class: 'test'
},
2022-10-15 10:26:10 +00:00
script: [ { children: 'console.log(\'Hello world\')' } ]
2022-08-02 11:43:25 +00:00
})
< / script >
```
2022-10-12 17:00:17 +00:00
::ReadMore{link="/api/composables/use-head"}
::
## Components
2021-07-15 11:28:04 +00:00
2022-11-16 02:26:35 +00:00
Nuxt provides `<Title>` , `<Base>` , `<NoScript>` , `<Style>` , `<Meta>` , `<Link>` , `<Body>` , `<Html>` and `<Head>` components so that you can interact directly with your metadata within your component's template.
2021-07-15 11:28:04 +00:00
Because these component names match native HTML elements, it is very important that they are capitalized in the template.
`<Head>` and `<Body>` can accept nested meta tags (for aesthetic reasons) but this has no effect on _where_ the nested meta tags are rendered in the final HTML.
2022-10-12 17:00:17 +00:00
### Example
2021-07-15 11:28:04 +00:00
2022-04-04 10:56:10 +00:00
<!-- @case -police-ignore html -->
2022-04-21 14:58:43 +00:00
```vue{}[app.vue]
< script setup >
const title = ref('Hello World')
< / script >
2021-07-15 11:28:04 +00:00
< template >
< div >
2022-04-21 14:58:43 +00:00
< Head >
< Title > {{ title }}< / Title >
< Meta name = "description" :content = "title" / >
< Style type = "text/css" children = "body { background-color: green; }" / >
< / Head >
< h1 > {{ title }}< / h1 >
2021-07-15 11:28:04 +00:00
< / div >
< / template >
```
2022-03-08 18:02:10 +00:00
2022-10-12 17:00:17 +00:00
## Types
The below is the non-reactive types used for `useHead` , `app.head` and components.
```ts
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 [zhead ](https://github.com/harlan-zw/zhead/tree/main/packages/schema/src ) for more detailed types.
## Features
### Reactivity
Reactivity is supported on all properties, as computed, computed getter refs and reactive.
It's recommended to use computed getters (`() => {}`) over computed (`computed(() => {})`).
::code-group
```vue [useHead]
< script setup lang = "ts" >
const desc = ref('My amazing site.')
2022-11-16 02:26:35 +00:00
2022-10-12 17:00:17 +00:00
useHead({
meta: [
{ name: 'description', content: desc }
],
})
< / script >
```
```vue [Components]
< script setup >
const desc = ref('My amazing site.')
< / script >
< template >
< div >
< Meta name = "description" :content = "desc" / >
< / div >
< / template >
```
::
### Title Templates
You can use the `titleTemplate` option to provide a dynamic template for customizing the title of your site. for example, by adding the name of your site to the title of every page.
The `titleTemplate` can either be a string, where `%s` is replaced with the title, or a function.
If you want to use a function (for full control), then this cannot be set in your `nuxt.config` , and it is recommended instead to set it within your `app.vue` file, where it will apply to all pages on your site:
::code-group
```vue [useHead]
< script setup lang = "ts" >
useHead({
titleTemplate: (titleChunk) => {
return titleChunk ? `${titleChunk} - Site Title` : 'Site Title';
}
})
< / script >
```
::
Now, if you set the title to `My Page` with `useHead` on another page of your site, the title would appear as 'My Page - Site Title' in the browser tab. You could also pass `null` to default to the site title.
### Body Tags
You can use the `body: true` option on the `link` and `script` meta tags to append them to the end of the `<body>` tag.
For example:
2022-11-16 02:26:35 +00:00
```vue
< script setup lang = "ts" >
useHead({
script: [
{
src: 'https://third-party-script.com',
body: true
}
]
})
< / script >
```
2022-10-12 17:00:17 +00:00
## Examples
### Usage With `definePageMeta`
2022-03-08 18:02:10 +00:00
2022-06-30 09:37:24 +00:00
Within your `pages/` directory, you can use `definePageMeta` along with `useHead` to set metadata based on the current route.
2022-03-08 18:02:10 +00:00
2022-04-11 09:03:31 +00:00
For example, you can first set the current page title (this is extracted at build time via a macro, so it can't be set dynamically):
2022-03-08 18:02:10 +00:00
```vue{}[pages/some-page.vue]
< script setup >
definePageMeta({
title: 'Some Page'
})
< / script >
```
2022-04-16 13:53:36 +00:00
And then in your layout file, you might use the route's metadata you have previously set:
2022-03-08 18:02:10 +00:00
```vue{}[layouts/default.vue]
< script setup >
const route = useRoute()
2022-04-05 14:02:29 +00:00
useHead({
2022-11-14 10:32:05 +00:00
meta: [{ property: 'og:title', content: `App Name - ${route.meta.title}` }]
2022-03-08 18:02:10 +00:00
})
< / script >
```
2022-04-09 09:25:13 +00:00
2022-10-25 09:33:09 +00:00
::LinkExample{link="/examples/composables/use-head"}
::
2022-06-30 09:37:24 +00:00
:ReadMore{link="/guide/directory-structure/pages/#page-metadata"}
2022-10-12 17:00:17 +00:00
### Add Dynamic Title
In the example below, `titleTemplate` is set either as a string with the `%s` placeholder or as a `function` , which allows greater flexibility in setting the page title dynamically for each route of your Nuxt app:
```vue [app.vue]
< script setup >
useHead({
// as a string,
// where `%s` is replaced with the title
titleTemplate: '%s - Site Title',
2022-11-16 02:26:35 +00:00
// ... or as a function
2022-10-12 17:00:17 +00:00
titleTemplate: (productCategory) => {
return productCategory
? `${productCategory} - Site Title`
: 'Site Title'
}
})
< / script >
```
`nuxt.config` is also used as an alternative way of setting the page title. However, `nuxt.config` does not allow the page title to be dynamic. Therefore, it is recommended to use `titleTemplate` in the `app.vue` file to add a dynamic title, which is then applied to all routes of your Nuxt app.
### Add External CSS
The example below inserts Google Fonts using the `link` property of the `useHead` composable:
::code-group
```vue [useHead]
2022-11-16 02:26:35 +00:00
< script setup lang = "ts" >
2022-10-12 17:00:17 +00:00
useHead({
link: [
2022-11-16 02:26:35 +00:00
{
rel: 'preconnect',
2022-10-12 17:00:17 +00:00
href: 'https://fonts.googleapis.com'
},
2022-11-16 02:26:35 +00:00
{
rel: 'stylesheet',
href: 'https://fonts.googleapis.com/css2?family=Roboto& display=swap',
crossorigin: ''
2022-10-12 17:00:17 +00:00
}
]
})
< / script >
```
```vue [Components]
< template >
< div >
< Link rel = "preconnect" href = "https://fonts.googleapis.com" / >
< Link rel = "stylesheet" href = "https://fonts.googleapis.com/css2?family=Roboto&display=swap" crossorigin = "" / >
< / div >
< / template >
```
::
