--- title: Font Optimization description: Learn how to optimize fonts in Next.js url: "https://nextjs.org/docs/app/getting-started/fonts" version: 16.2.2 lastUpdated: 2026-04-02 prerequisites: - "Getting Started: /docs/app/getting-started" related: - app/api-reference/components/font --- The [`next/font`](/docs/app/api-reference/components/font) module automatically optimizes your fonts and removes external network requests for improved privacy and performance. It includes **built-in self-hosting** for any font file. This means you can optimally load web fonts with no layout shift. To start using `next/font`, import it from [`next/font/local`](#local-fonts) or [`next/font/google`](#google-fonts), call it as a function with the appropriate options, and set the `className` of the element you want to apply the font to. For example: ```tsx filename="app/layout.tsx" highlight={1,3-5,9} switcher import { Geist } from 'next/font/google' const geist = Geist({ subsets: ['latin'], }) export default function Layout({ children }: { children: React.ReactNode }) { return ( {children} ) } ``` ```jsx filename="app/layout.js" highlight={1,3-5,9} switcher import { Geist } from 'next/font/google' const geist = Geist({ subsets: ['latin'], }) export default function Layout({ children }) { return ( {children} ) } ``` Fonts are scoped to the component they're used in. To apply a font to your entire application, add it to the [Root Layout](/docs/app/api-reference/file-conventions/layout#root-layout). ## Google fonts You can automatically self-host any Google Font. Fonts are included stored as static assets and served from the same domain as your deployment, meaning no requests are sent to Google by the browser when the user visits your site. To start using a Google Font, import your chosen font from `next/font/google`: ```tsx filename="app/layout.tsx" switcher import { Geist } from 'next/font/google' const geist = Geist({ subsets: ['latin'], }) export default function RootLayout({ children, }: { children: React.ReactNode }) { return ( {children} ) } ``` ```jsx filename="app/layout.js" switcher import { Geist } from 'next/font/google' const geist = Geist({ subsets: ['latin'], }) export default function RootLayout({ children }) { return ( {children} ) } ``` We recommend using [variable fonts](https://fonts.google.com/variablefonts) for the best performance and flexibility. But if you can't use a variable font, you will need to specify a weight: ```tsx filename="app/layout.tsx" highlight={4} switcher import { Roboto } from 'next/font/google' const roboto = Roboto({ weight: '400', subsets: ['latin'], }) export default function RootLayout({ children, }: { children: React.ReactNode }) { return ( {children} ) } ``` ```jsx filename="app/layout.js" highlight={4} switcher import { Roboto } from 'next/font/google' const roboto = Roboto({ weight: '400', subsets: ['latin'], }) export default function RootLayout({ children }) { return ( {children} ) } ``` ## Local fonts To use a local font, import the `localFont` function from `next/font/local` and specify the [`src`](/docs/app/api-reference/components/font#src) of your local font file. The path is resolved relative to the file where `localFont` is called. Fonts can be stored anywhere in the project, including the [`public`](/docs/app/api-reference/file-conventions/public-folder) folder or co-located inside the `app` folder. For example, to use a font stored in `app/fonts/`: ```tsx filename="app/layout.tsx" switcher import localFont from 'next/font/local' const myFont = localFont({ src: './my-font.woff2', }) export default function RootLayout({ children, }: { children: React.ReactNode }) { return ( {children} ) } ``` ```jsx filename="app/layout.js" switcher import localFont from 'next/font/local' const myFont = localFont({ src: './my-font.woff2', }) export default function RootLayout({ children }) { return ( {children} ) } ``` If you want to use multiple files for a single font family, `src` can be an array: ```js const roboto = localFont({ src: [ { path: './Roboto-Regular.woff2', weight: '400', style: 'normal', }, { path: './Roboto-Italic.woff2', weight: '400', style: 'italic', }, { path: './Roboto-Bold.woff2', weight: '700', style: 'normal', }, { path: './Roboto-BoldItalic.woff2', weight: '700', style: 'italic', }, ], }) ``` ## API Reference See the API Reference for the full feature set of Next.js Font - [Font](/docs/app/api-reference/components/font) - Optimizing loading web fonts with the built-in `next/font` loaders. --- For a semantic overview of all documentation, see [/docs/sitemap.md](/docs/sitemap.md) For an index of all available documentation, see [/docs/llms.txt](/docs/llms.txt)