no-head-import-in-document.mdx


title: No Head Import in Document

Prevent usage of next/head in pages/_document.js.

Why This Error Occurred

next/head was imported in pages/_document.js. This can cause unexpected issues in your application.

Possible Ways to Fix It

Only import and use next/document within pages/_document.js to override the default Document component. If you are importing next/head to use the Head component, import it from next/document instead in order to modify <head> code across all pages:

import Document, { Html, Head, Main, NextScript } from 'next/document'

class MyDocument extends Document {
  static async getInitialProps(ctx) {
    //...
  }

  render() {
    return (
      <Html>
        <Head></Head>
      </Html>
    )
  }
}

export default MyDocument

Rendered from the public repository vercel/next.js on GitHub; content belongs to its authors. Cached for up to an hour.

errors/no-head-import-in-document.mdx · vercel/next.js | Docs MD