Routing

Last updated April 23, 2026

The Pages Router has a file-system based router built on concepts of pages. When a file is added to the pages directory it's automatically available as a route. Learn more about routing in the Pages Router:

[

Pages and Layouts

Create your first page and shared layout with the Pages Router.

](pages-and-layouts/index.md)[

Dynamic Routes

Dynamic Routes are pages that allow you to add custom params to your URLs. Start creating Dynamic Routes and learn more here.

](dynamic-routes/index.md)[

Linking and Navigating

Learn how navigation works in Next.js, and how to use the Link Component and `useRouter` hook.

](linking-and-navigating/index.md)[

Custom App

Control page initialization and add a layout that persists for all pages by overriding the default App component used by Next.js.

](custom-app/index.md)[

Custom Document

Extend the default document markup added by Next.js.

](custom-document/index.md)[

API Routes

Next.js supports API Routes, which allow you to build your API without leaving your Next.js app. Learn how it works here.

](api-routes/index.md)[

Custom Errors

Override and extend the built-in Error page to handle custom errors.

](custom-error/index.md)

Was this helpful?