Nuxt.js gives you 3 different ways to add meta data to your application:
- Globally using the nuxt.config.js
- Locally using the head as an object
- Locally using the head as a function so that you have access to data and computed properties.
Global Settings
Nuxt.js lets you define all default <meta>
tags for your application inside the nuxt.config.js file using the head property. This is very useful for adding a default title and description tag for SEO purposes or for setting the viewport or adding the favicon.
nuxt.config.js
export default {
head: {
title: 'my website title',
meta: [
{ charset: 'utf-8' },
{ name: 'viewport', content: 'width=device-width, initial-scale=1' },
{
hid: 'description',
name: 'description',
content: 'my website description'
}
],
link: [{ rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }]
}
}
This will give you the same title and description on every page
Local Settings
You can also add titles and meta for each page using the head
method inside your script tag on every page.
pages/index.vue
<script>
export default {
head: {
title: 'Home page',
meta: [
{
hid: 'description',
name: 'description',
content: 'Home page description'
}
],
}
}
</script>
Use head
as an object to set a title and description only for the home page
pages/index.vue
<template>
<h1>{{ title }}</h1>
</template>
<script>
export default {
data() {
return {
title: 'Home page'
}
},
head() {
return {
title: this.title,
meta: [
{
hid: 'description',
name: 'description',
content: 'Home page description'
}
]
}
}
}
</script>
Use head
as a function to set a title and description only for the home page. By using a function you have access to data and computed properties
Nuxt.js uses vue-meta to update the document head and meta attributes of your application.
To avoid any duplication when used in child components, please give a unique identifier with the hid
key to the meta description. This way vue-meta
will know that it has to overwrite the default tag.
Learn more about the options available for head
, in the vue-meta documentation.
External Resources
You can include external resources such as scripts and fonts by adding them globally to the nuxt.config.js
or locally in the head
object or function.
You can also pass each resource an optional body: true
to include the resource before the closing </body>
tag.
Global Settings
nuxt.config.js
export default {
head: {
script: [
{
src: 'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min.js'
}
],
link: [
{
rel: 'stylesheet',
href: 'https://fonts.googleapis.com/css?family=Roboto&display=swap'
}
]
}
}
Local Settings
pages/index.vue
<template>
<h1>About page with jQuery and Roboto font</h1>
</template>
<script>
export default {
head() {
return {
script: [
{
src:
'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.min.js'
}
],
link: [
{
rel: 'stylesheet',
href: 'https://fonts.googleapis.com/css?family=Roboto&display=swap'
}
]
}
}
}
</script>
<style scoped>
h1 {
font-family: Roboto, sans-serif;
}
</style>
Resource Hints
Adds prefetch and preload links for faster initial page load time.
You may want to only disable this option if you have many pages and routes.