Parallel Routes let you render multiple pages simultaneously within the same layout. Instead of navigating away from a page to show another one, you can display both at the same time — a dashboard with independently navigable sections, a main content area alongside a sidebar that changes with its own navigation, or a feed with an openable detail panel that doesn't replace the feed.
This is one of the more powerful App Router features and one of the more confusing to set up initially. Here's the complete pattern, including the design approach used for complex multi-panel interfaces like the generation tool at Pixova.
Parallel routes use named slots: special folders prefixed with @
that define independent rendering areas within a layout.
app/
├── layout.tsx ← Receives slot props
├── page.tsx ← Default slot content
├── @sidebar/
│ ├── page.tsx ← Sidebar default
│ └── settings/
│ └── page.tsx ← Sidebar settings view
└── @modal/
├── page.tsx ← Modal default (null)
└── photo/[id]/
└── page.tsx ← Photo modal
The layout receives each slot as a prop:
// app/layout.tsx
export default function Layout({
children,
sidebar,
modal,
}: {
children: React.ReactNode;
sidebar: React.ReactNode;
modal: React.ReactNode;
}) {
return (
<div className="flex h-screen">
<aside className="w-64 border-r">{sidebar}</aside>
<main className="flex-1">{children}</main>
{modal}
</div>
);
}
Now children
, sidebar
, and modal
can each navigate independently.
Each parallel route slot navigates independently. When a user navigates from /
to /settings
, the children
slot updates. The sidebar
slot stays exactly where it was — its navigation state is independent.
This is the key difference from nested layouts. Nested layouts rerender from the changed segment outward. Parallel routes don't affect each other.
User is at / (children shows home, sidebar shows default nav)
User navigates to /settings
→ children now shows settings
→ sidebar unchanged, still shows default nav
User then clicks "Account" in sidebar
→ sidebar now shows account content
→ children unchanged, still shows settings
When a route navigates and a parallel slot doesn't have content for that URL, Next.js needs to know what to show. This is where default.tsx
comes in:
app/
├── @sidebar/
│ ├── default.tsx ← Shown when sidebar has no matching route
│ └── filters/
│ └── page.tsx
└── @modal/
└── default.tsx ← Usually null — modal is hidden by default
// app/@modal/default.tsx
// Return null when no modal should be shown
export default function ModalDefault() {
return null;
}
// app/@sidebar/default.tsx
// Sidebar shows its default nav when no specific route is active
export default function SidebarDefault() {
return <DefaultNavigation />;
}
Without default.tsx
, navigating to a URL that doesn't match a slot will cause a 404 or error.
The most compelling use of parallel routes: opening a detail modal without losing the underlying page, then being able to close the modal and return to the page — with full URL sharing support.
app/
├── @modal/
│ ├── default.tsx ← null (no modal)
│ └── photos/
│ └── [id]/
│ └── page.tsx ← Photo detail modal
├── layout.tsx
└── photos/
└── page.tsx ← Photo grid
When a user navigates to /photos/123
, the @modal
slot renders the photo detail while the photo grid stays visible underneath:
// app/@modal/photos/[id]/page.tsx
'use client';
import { useRouter } from 'next/navigation';
export default function PhotoModal({ params }: { params: { id: string } }) {
const router = useRouter();
return (
<div
className="fixed inset-0 bg-black/60 flex items-center justify-center z-50"
onClick={() => router.back()}
>
<div
className="bg-white rounded-xl max-w-2xl w-full mx-4 p-6"
onClick={e => e.stopPropagation()}
>
<PhotoDetail id={params.id} />
</div>
</div>
);
}
// app/@modal/default.tsx
export default function ModalDefault() {
return null; // No modal rendered
}
The URL /photos/123
can be shared and when followed directly, the photo modal renders. When navigated to from within the app, the grid stays visible underneath. router.back()
closes the modal and returns to the photo grid.
Intercepting routes extend the modal pattern: intercept a link that would normally navigate away and instead show the content in a modal.
app/
├── photos/
│ ├── page.tsx ← Photo grid
│ └── [id]/
│ └── page.tsx ← Photo page (for direct access)
└── @modal/
├── default.tsx ← null
└── (.)photos/ ← Intercepts /photos/:id when navigating from same level
└── [id]/
└── page.tsx ← Photo in modal
The (.)
syntax intercepts routes at the same level. (..)
intercepts one level up. (...)
intercepts from root.
When a user clicks a photo link from the grid, (.)photos/[id]
intercepts and shows the modal. When they refresh or share the URL /photos/123
, Next.js serves photos/[id]/page.tsx
— the full page version.
Use parallel routes for:
Don't use parallel routes for:
The file system complexity of parallel routes is only worth it when you genuinely need independent URL-based navigation in multiple slots simultaneously.
Each parallel route slot can have its own and error states:
app/
├── @sidebar/
│ ├── .tsx ← Sidebar skeleton
│ ├── error.tsx ← Sidebar error state
│ └── page.tsx
└── @modal/
├── .tsx ← Modal state
└── ...
This means the sidebar can show a skeleton while without affecting the main content area, and a sidebar error doesn't break the rest of the page.
// app/@sidebar/.tsx
export default function Sidebar() {
return (
<div className="p-4 space-y-3">
{[...Array(5)].map((_, i) => (
<div key={i} className="h-8 bg-neutral-100 rounded animate-pulse" />
))}
</div>
);
}
Parallel routes use @named
folders to define independent rendering slots in a layout. Each slot navigates independently — changes in one slot don't affect others.
The essential files: layout.tsx
accepts slot props, default.tsx
provides fallback content when a slot has no matching route, .tsx
and error.tsx
give per-slot and error states.
The modal pattern — pairing parallel routes with intercepting routes for URL-addressable modals that don't replace the underlying page — is the feature's most powerful application.
Slot showing wrong content after navigation: Check that default.tsx
exists for each slot at every level where navigation could leave the slot without matching content.
404 when navigating parallel routes: Usually means a default.tsx
is missing. Every @slot
folder that could be in a "no matching route" state needs a default.tsx
.
Slots affecting each other: Parallel route slots are independent — if a change in one is affecting another, check that the layout isn't rerendering more than expected. Use React DevTools to verify slot isolation.
Refresh shows different content than navigation: This is the intercepting route working correctly — direct access shows the full page, navigation within the app intercepts to show the modal. If you don't want this behavior, remove the intercept folder.
For a dashboard with an independent sidebar and an optional modal:
app/
├── layout.tsx # children + sidebar + modal slots
├── page.tsx # Main content default
├── settings/
│ └── page.tsx # Main content: settings
├── @sidebar/
│ ├── default.tsx # Default sidebar nav
│ ├── page.tsx # Sidebar: home
│ └── admin/
│ └── page.tsx # Sidebar: admin nav
└── @modal/
├── default.tsx # null — no modal
└── (.)items/
└── [id]/
└── page.tsx # Item detail modal
That structure handles: independent sidebar navigation, optional modals that intercept item links, URL-addressable modal state, and per-slot /error states — all with clean URL semantics.