Dynamic Routing
All Next.js topics∙ Next.js
Dynamic routes use bracketed folder names such as [slug] to match variable URL segments. This lesson explains how it works, when to use it, how to implement it safely, and how to verify the result.
Syntax
app/posts/[slug]/page.tsxExample
// Topic: Dynamic Routing
import { notFound } from 'next/navigation';
export default async function PostPage({ params }) {
const { slug } = await params;
const post = await getPost(slug);
if (!post) notFound();
return <h1>{post.title}</h1>;
}Expected Output
The URL slug selects the matching post.Line-by-line
| Line | Meaning |
|---|---|
import { notFound } from 'next/navigation'; | Imports a component or framework API used by the example. |
export default async function PostPage({ params }) { | Exports the React component that Next.js renders for the route. |
const { slug } = await params; | Reads the resolved dynamic route parameters. |
const post = await getPost(slug); | Stores a value used later in the example. |
if (!post) notFound(); | Stops rendering and displays the nearest not-found UI. |
return <h1>{post.title}</h1>; | Returns the response or interface produced by the function. |
} | Forms part of the component, server operation, or configuration shown above. |
Real-World Uses
- 1Dynamic Routing is useful for building multi-page applications with stable URLs, shared layouts, and deep links.
- 2For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
- 3A team should use it when the requirement matches its responsibility in routing.
- 4It should fit the surrounding route, data, security, and deployment design instead of being added in isolation.
- 5A successful implementation is visible through correct URLs, predictable layouts, and navigation without full-page reloads.
- 6SaaS products use Dynamic Routing in services, dashboards, background jobs, and API workflows.
- 7ERP and banking systems apply Dynamic Routing with validation, logging, review, and rollback plans.
- 8E-commerce and healthcare platforms use Dynamic Routing carefully because reliability and data correctness matter.
Common Mistakes
- 1Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
- 2Copying an example without identifying which code runs on the server and which code reaches the browser.
- 3Handling only the happy path and forgetting loading, empty, invalid, unauthorized, and failed states.
- 4Adding client state or third-party libraries before confirming that built-in Next.js and browser features are insufficient.
- 5Skipping verification in a production build, where caching and runtime behavior can differ from development.
- 6Skipping the small working example before adding framework code.
- 7Ignoring null, empty, duplicate, and boundary inputs.
- 8Mixing business logic, input handling, and output formatting in one place.
- 9Using broad error handling that hides the real failure.
- 10Forgetting to test the behavior after refactoring.
- 11Adding clever code that future maintainers will struggle to read.
- 12Not checking performance on realistic input sizes.
Best Practices
- 1Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
- 2Keep the owning route, component, server function, and validation responsibility easy to identify.
- 3Use server-side code for trusted data and secrets; send only the data required by interactive browser components.
- 4Make loading, empty, success, and error states explicit for the user.
- 5Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
- 6Start with clear requirements and one minimal working example.
- 7Use meaningful names that explain business intent.
- 8Keep examples small enough to debug line by line.
- 9Validate input at every trust boundary.
- 10Handle errors explicitly and preserve useful context.
- 11Prefer simple control flow over deeply nested logic.
- 12Separate domain logic from I/O and framework code.
- 13Write tests for normal, boundary, and failure cases.
- 14Review security assumptions before production use.
- 15Measure performance before optimizing.
- 16Document non-obvious decisions close to the code or in project notes.
- 17Use official documentation when behavior is version-specific.
- 18Keep dependencies current and remove unused code.
- 19Avoid hardcoded secrets, credentials, and environment-specific paths.
- 20Log operational events without exposing sensitive data.
- 21Design examples so learners can safely modify and rerun them.
- 22Prefer maintainability over short-term cleverness.
What it means
- 1Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
- 2The important question is not only what syntax to write, but what responsibility this feature owns.
- 3Its behavior should be understood in development, during a production build, and after deployment.
- 4Before implementing it, decide what input it receives, what result it produces, and how failure is shown.
How it works
- 1For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
- 2Next.js uses file and component boundaries to decide routing, server execution, browser execution, and caching.
- 3Data should cross each boundary in a small, serializable, and validated form.
- 4The final result should remain understandable when a user refreshes the page or opens the URL directly.
Step-by-step approach
- 1Create the smallest route or component that demonstrates Dynamic Routing.
- 2Add one realistic input or data source and show the successful result.
- 3Add the most likely failure case and display a useful response.
- 4Run this check: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
Production checklist
- 1Confirm server-only values and secrets never enter the browser bundle.
- 2Confirm direct URLs, refreshes, loading states, and errors behave correctly.
- 3Confirm caching and revalidation match the required data freshness.
- 4Measure the result using correct URLs, predictable layouts, and navigation without full-page reloads.
Real-world use cases
- 1Dynamic Routing is useful for building multi-page applications with stable URLs, shared layouts, and deep links.
- 2For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
- 3A team should use it when the requirement matches its responsibility in routing.
- 4It should fit the surrounding route, data, security, and deployment design instead of being added in isolation.
- 5A successful implementation is visible through correct URLs, predictable layouts, and navigation without full-page reloads.
- 6SaaS products use Dynamic Routing in services, dashboards, background jobs, and API workflows.
- 7ERP and banking systems apply Dynamic Routing with validation, logging, review, and rollback plans.
- 8E-commerce and healthcare platforms use Dynamic Routing carefully because reliability and data correctness matter.
Internal working
- 1A Next.js program first evaluates the surrounding context, then applies the Dynamic Routing rules to the current data.
- 2The important mental model is input, transformation, result, and failure path.
- 3In production, the same flow usually sits inside a larger layer such as a controller, service, repository, job, or UI component.
Performance considerations
- 1Choose the simplest implementation first, then measure real workloads.
- 2Watch for repeated work inside loops, unnecessary allocations, and slow I/O in hot paths.
- 3Prefer clear data structures and stable APIs before micro-optimizing syntax.
Security considerations
- 1Treat external input as untrusted until it is validated.
- 2Avoid hardcoded secrets and never print sensitive values in examples or logs.
- 3Use established libraries for authentication, encryption, parsing, and database access.
Common mistakes
- 1Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
- 2Copying an example without identifying which code runs on the server and which code reaches the browser.
- 3Handling only the happy path and forgetting loading, empty, invalid, unauthorized, and failed states.
- 4Adding client state or third-party libraries before confirming that built-in Next.js and browser features are insufficient.
- 5Skipping verification in a production build, where caching and runtime behavior can differ from development.
- 6Skipping the small working example before adding framework code.
- 7Ignoring null, empty, duplicate, and boundary inputs.
- 8Mixing business logic, input handling, and output formatting in one place.
- 9Using broad error handling that hides the real failure.
- 10Forgetting to test the behavior after refactoring.
Professional best practices
- 1Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
- 2Keep the owning route, component, server function, and validation responsibility easy to identify.
- 3Use server-side code for trusted data and secrets; send only the data required by interactive browser components.
- 4Make loading, empty, success, and error states explicit for the user.
- 5Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
- 6Start with clear requirements and one minimal working example.
- 7Use meaningful names that explain business intent.
- 8Keep examples small enough to debug line by line.
- 9Validate input at every trust boundary.
- 10Handle errors explicitly and preserve useful context.
- 11Prefer simple control flow over deeply nested logic.
- 12Separate domain logic from I/O and framework code.
- 13Write tests for normal, boundary, and failure cases.
- 14Review security assumptions before production use.
- 15Measure performance before optimizing.
- 16Document non-obvious decisions close to the code or in project notes.
- 17Use official documentation when behavior is version-specific.
- 18Keep dependencies current and remove unused code.
- 19Avoid hardcoded secrets, credentials, and environment-specific paths.
- 20Log operational events without exposing sensitive data.
Coding exercises
- 1Beginner: rewrite the example with different names and values.
- 2Intermediate: add validation and handle one expected failure case.
- 3Advanced: place Dynamic Routing inside a small service-style design with tests.
Mini project
- 1Build a small Next.js console feature that demonstrates Dynamic Routing.
- 2Accept input, process it with the concept, print a clear result, and handle invalid input.
- 3Add a README note explaining the design choice and two edge cases you tested.
Troubleshooting
- 1If the program does not compile, check spelling, imports, braces, and file/class names first.
- 2If output is unexpected, print intermediate values and verify each branch of the logic.
- 3If the design feels complex, reduce it to the smallest working example and add pieces back one at a time.
Next steps
- 1Practice Dynamic Routing with a second example from a business domain such as inventory, payroll, banking, or e-commerce.
- 2Review related Next.js topics that cover data flow, error handling, testing, and clean design.
- 3Compare your solution with official documentation and simplify anything you cannot explain clearly.
Quick Summary
- Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
- For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
- Recommended approach: Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
- Main mistake to avoid: Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
- Verify it by doing the following: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
Interview Questions
Q1. What is Dynamic Routing?
Answer: Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
Q2. How does Dynamic Routing work in Next.js?
Answer: For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
Q3. When should you use Dynamic Routing?
Answer: Use it for building multi-page applications with stable URLs, shared layouts, and deep links, when that responsibility belongs inside the Next.js application.
Q4. What is a common mistake with Dynamic Routing?
Answer: Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
Q5. How would you test Dynamic Routing?
Answer: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks. The result should demonstrate correct URLs, predictable layouts, and navigation without full-page reloads.
Q6. What mistakes should be avoided with Dynamic Routing?
Answer: Trusting client input without server validation. Ignoring loading, empty, and error states.
Q7. How do you debug problems with Dynamic Routing?
Answer: Reduce the code to a minimal example, inspect inputs and outputs, then add logging or tests around the failing path.
Q8. How does Dynamic Routing affect maintainability?
Answer: It improves maintainability when responsibilities are clear, names are meaningful, and edge cases are tested.
Q9. How would you use Dynamic Routing in an enterprise project?
Answer: Place it behind a clear service, validate inputs, handle errors, log useful context, and cover the behavior with tests.
Q10. What performance concern should you check with Dynamic Routing?
Answer: Measure realistic data sizes and look for repeated work, blocking I/O, excessive allocation, or unnecessary framework overhead.
Q11. What security concern should you check with Dynamic Routing?
Answer: Validate untrusted input, avoid leaking sensitive data, and use proven libraries for security-sensitive work.
Q12. How do you explain Dynamic Routing to a beginner?
Answer: Start with the problem it solves, show the smallest working example, then explain each line and one common mistake.
Q13. What should you test for Dynamic Routing?
Answer: Test a normal case, an empty or invalid case, a boundary case, and one expected failure path.
Q14. How do you know if Dynamic Routing is the wrong choice?
Answer: It is probably wrong if it adds complexity without improving clarity, safety, reuse, or performance.
Q15. How does Dynamic Routing connect to clean code?
Answer: Clean code uses the concept with clear names, small scopes, predictable behavior, and minimal hidden side effects.
Q16. What documentation is useful for Dynamic Routing?
Answer: Document assumptions, edge cases, version-specific behavior, and any production decision that is not obvious from the code.
Q17. How should code using Dynamic Routing be reviewed?
Answer: Review correctness first, then readability, failure handling, security boundaries, performance, and tests.
Q18. What is a practical exercise for Dynamic Routing?
Answer: Build a small feature, change the inputs, add one validation rule, and explain the result in your own words.
Q19. How does Dynamic Routing appear in APIs?
Answer: It often appears in validation, request processing, transformation, persistence, or response formatting depending on the topic.
Q20. How does Dynamic Routing appear in SaaS products?
Answer: SaaS teams use it inside repeatable workflows where correctness, observability, and maintainability matter.
Q21. How does Dynamic Routing appear in ERP systems?
Answer: ERP systems use it around structured business rules such as orders, invoices, inventory, employees, and approvals.
Quiz
Which approach is best when implementing Dynamic Routing?