Parallel routes (@slot) in NextJS

Introduction

Parallel routes let you show different parts of a page at the same time. They help build complex layouts easily.

You want to show a sidebar and main content side by side.

You need to load multiple sections independently on the same page.

You want to keep some UI parts visible while changing others.

You want to reuse layout parts without repeating code.

Syntax

NextJS

export const metadata = { title: 'Layout Title' };

export default function Layout({ sidebar, content }) {
  return (
    <>
      {sidebar}
      {content}
    </>
  );
}

The @slot syntax defines where parallel routes render their content.

Each slot has a unique name to match the route segment.

Examples

This layout shows two slots: one for a menu and one for main content.

NextJS

export default function Layout({ menu, main }) {
  return (
    <>
      {menu}
      {main}
    </>
  );
}

Here, three slots let you show navigation, dashboard, and notifications side by side.

NextJS

export default function DashboardLayout({ nav, dashboard, notifications }) {
  return (
    <>
      {nav}
      {dashboard}
      {notifications}
    </>
  );
}

Sample Program

This example shows a root layout with two slots: sidebar and content. Each slot renders a different route segment side by side using flexbox.

NextJS

export default function RootLayout({ sidebar, content }) {
  return (
    <html lang="en">
      <body>
        <div style={{ display: 'flex', gap: '1rem' }}>
          {sidebar}
          {content}
        </div>
      </body>
    </html>
  );
}

// In app/(sidebar)/page.js
export default function Sidebar() {
  return <nav>Sidebar menu</nav>;
}

// In app/(content)/page.js
export default function Content() {
  return <main>Main content area</main>;
}

Important Notes

Slots must have unique names to avoid conflicts.

Parallel routes help keep UI parts independent and reusable.

Use CSS like flexbox to arrange slots visually side by side.

Summary

Parallel routes use @slot to show multiple UI parts at once.

Each slot matches a route segment with the same name.

This helps build flexible and reusable layouts easily.

Practice

1. What is the main purpose of using @slot in Next.js parallel routes?

easy

A. To display multiple UI parts simultaneously in different route segments

B. To fetch data from an API endpoint

C. To define server-side rendering behavior

D. To create dynamic API routes

Solution

1. Step 1: Understand the role of @slot

   @slot is used to show multiple UI parts at once by matching route segments.

2. Step 2: Identify the purpose in parallel routes

   It allows different UI sections to render in parallel, improving layout flexibility.

3. Final Answer:

   To display multiple UI parts simultaneously in different route segments -> Option A

4. Quick Check:

   Parallel routes use @slot to show multiple UI parts [OK]

Hint: Remember: @slot shows multiple UI parts at once [OK]

Common Mistakes:

• Confusing @slot with data fetching
• Thinking @slot controls API routes
• Assuming @slot is for server rendering only

2. Which of the following is the correct syntax to define a parallel route slot named sidebar in Next.js?

easy

A. export const @slot sidebar = () => <div>Sidebar</div>;

B. export const slot_sidebar = () => <div>Sidebar</div>;

C. export const sidebar = () => <div>Sidebar</div>;

D. export const SidebarSlot = () => <div>Sidebar</div>;

Solution

1. Step 1: Recall parallel route slot syntax

   Slots are exported as named exports matching the slot name, e.g., export const sidebar.

2. Step 2: Check each option

   export const sidebar = () => <div>Sidebar</div>; correctly exports a constant named sidebar as a React component.

3. Final Answer:

   export const sidebar = () => <div>Sidebar</div>; -> Option C

4. Quick Check:

   Slot name matches export const name [OK]

Hint: Export slot as named const matching slot name [OK]

Common Mistakes:

• Using @slot keyword in export
• Prefixing slot name incorrectly
• Using PascalCase instead of slot name

3. Given this Next.js parallel route layout code:

export const header = () => <header>Header</header>;
export const footer = () => <footer>Footer</footer>;

export default function Page() {
  return <main>Main Content</main>;
}

What will be rendered on the page?

medium

A. Only <main>Main Content</main> is rendered

B. <header>Header</header>, <main>Main Content</main>, and <footer>Footer</footer> are all rendered

C. Only <header>Header</header> and <footer>Footer</footer> are rendered

D. Syntax error due to missing @slot usage

Solution

1. Step 1: Understand parallel route slots rendering

   Slots like header and footer render alongside the default export component.

2. Step 2: Combine all parts

   The page renders header, main content, and footer together as parallel UI parts.

3. Final Answer:

   <header>Header</header>, <main>Main Content</main>, and <footer>Footer</footer> are all rendered -> Option B

4. Quick Check:

   Parallel routes render all slots plus default [OK]

Hint: Slots and default export render together [OK]

Common Mistakes:

• Thinking only default export renders
• Assuming slots need explicit @slot tags in JSX
• Confusing syntax error with missing @slot

4. You wrote this code for a parallel route slot:

export const sidebar = () => <div>Sidebar</div>;

export default function Page() {
  return <main>Main</main>;
}

But the sidebar does not appear on the page. What is the likely cause?

medium

A. The slot name sidebar does not match any route segment

B. You forgot to import React

C. The default export must be named sidebar

D. Parallel routes require class components, not functions

Solution

1. Step 1: Check slot name and route segment matching

   Slots render only if their name matches a parallel route segment in the folder structure.

2. Step 2: Identify mismatch issue

   If no route segment named sidebar exists, the slot won't render.

3. Final Answer:

   The slot name sidebar does not match any route segment -> Option A

4. Quick Check:

   Slot name must match route segment [OK]

Hint: Match slot name exactly to route segment folder [OK]

Common Mistakes:

• Assuming React import is required in Next.js 13+
• Thinking default export must be slot named
• Believing only class components work for slots

5. You want to create a layout with parallel routes showing a nav bar and a content area side by side. Which folder structure and code setup correctly implements this using @slot?

hard

A. Folders: app/(nav)/page.tsx and app/(content)/page.tsx with export const nav = () => <nav>Nav</nav>; in nav folder and export default function Page() { return <main>Content</main>; } in content folder

B. Folders: app/(nav)/page.tsx and app/(content)/page.tsx with export default function Nav() { return <nav>Nav</nav>; } and export default function Content() { return <main>Content</main>; }

C. Folders: app/nav/page.tsx and app/content/page.tsx with export default function Nav() { return <nav>Nav</nav>; } and export default function Content() { return <main>Content</main>; }

D. Folders: app/nav/page.tsx and app/content/page.tsx with export const nav = () => <nav>Nav</nav>; in nav folder and export default function Page() { return <main>Content</main>; } in content folder

Solution

1. Step 1: Understand parallel route folder naming

   Parallel routes use folder names without parentheses to define slots, e.g., nav and content.

2. Step 2: Match slot export and default export

   In nav folder, export export const nav for the slot; in content folder, export default the main content.

3. Step 3: Verify options

   Folders: app/nav/page.tsx and app/content/page.tsx with export const nav = () => <nav>Nav</nav>; in nav folder and export default function Page() { return <main>Content</main>; } in content folder correctly uses folders app/nav and app/content with proper exports.

4. Final Answer:

   Folders: app/nav/page.tsx and app/content/page.tsx with export const nav and default export in content -> Option D

5. Quick Check:

   Folder names match slot names without parentheses [OK]

Hint: Use folder names matching slot names without parentheses [OK]

Common Mistakes:

• Using parentheses in folder names for slots
• Exporting slots as default exports
• Mixing slot export and default export roles