<Head>
Examples
We expose a built-in component for appending elements to the head
of the page:
Avoid duplicated tags
To avoid duplicate tags in your head
you can use the key
property, which will make sure the tag is only rendered once, as in the following example:
In this case only the second <meta property="og:title" />
is rendered. meta
tags with duplicate key
attributes are automatically handled.
Good to know:
<title>
and<base>
tags are automatically checked for duplicates by Next.js, so using key is not necessary for these tags.
The contents of
head
get cleared upon unmounting the component, so make sure each page completely defines what it needs inhead
, without making assumptions about what other pages added.
Use minimal nesting
title
, meta
or any other elements (e.g. script
) need to be contained as direct children of the Head
element,
or wrapped into maximum one level of <React.Fragment>
or arrays—otherwise the tags won't be correctly picked up on client-side navigations.
Use next/script
for scripts
We recommend using next/script
in your component instead of manually creating a <script>
in next/head
.
No html
or body
tags
You cannot use <Head>
to set attributes on <html>
or <body>
tags. This will result in an next-head-count is missing
error. next/head
can only handle tags inside the HTML <head>
tag.