Forms in Next.js — Complete Guide
Forms in Next.js — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of Next.js Tutorial on Toolliyo Academy.
On this page
Next.js Tutorial (LearnHub) · Lesson 18 of 100
Forms in Next.js
Beginner → Intermediate → Advanced → Professional
Beginner · 1 — Foundations · ~12 min read · Module 2: Layouts & Styling
Introduction
This lesson is part of the beginner section. We explain Forms in Next.js slowly, with examples you can copy and run. If something is unclear, read it twice — that is how everyone learns. Forms submit data to Server Actions or Route Handlers. Native
When will you use this?
You use layouts and styling in every page you build from your first screen to production.
- Course catalogs, lesson sidebars, and instructor dashboards all use layouts and shared navigation.
- When a student opens a lesson page, nested layouts keep the header and progress bar consistent.
Real-world: HDFC-style banking dashboard
The Banking team building HDFC-style banking dashboard uses Forms in Next.js to build sign-up, contact, and enrollment forms that work with Server Actions. account holders never see the TypeScript files — they just get a fast, reliable accounts, transfers, and statement views.
Production-style code
import { enrollInCourse } from '@/actions/enroll';
export default function EnrollForm({ courseId }: { courseId: string }) {
return (
<form action={enrollInCourse}>
<input type="hidden" name="courseId" value={courseId} />
<button type="submit">Enroll now</button>
</form>
);
}
What happens in production: In HDFC-style banking dashboard, getting Forms in Next.js right means account holders trust the accounts, transfers, and statement views every day.
Lesson example (start here)
Copy this smaller example first. Once it works, compare it with the real-world code above.
import { enrollInCourse } from '@/actions/enroll';
export default function EnrollForm({ courseId }: { courseId: string }) {
return (
<form action={enrollInCourse}>
<input type="hidden" name="courseId" value={courseId} />
<button type="submit">Enroll now</button>
</form>
);
}
Line-by-line walkthrough
| Code | What it means |
|---|---|
import { enrollInCourse } from '@/actions/enroll'; | Imports a module so you can use its exports in this file. |
export default function EnrollForm({ courseId }: { courseId: string }) { | Default export — the main page or component this file provides to Next.js. |
return ( | Returns JSX — what the user sees in the browser. |
<form action={enrollInCourse}> | Part of the Forms in Next.js example — read it together with the lines before and after. |
<input type="hidden" name="courseId" value={courseId} /> | Part of the Forms in Next.js example — read it together with the lines before and after. |
<button type="submit">Enroll now</button> | Part of the Forms in Next.js example — read it together with the lines before and after. |
</form> | Part of the Forms in Next.js example — read it together with the lines before and after. |
); | Part of the Forms in Next.js example — read it together with the lines before and after. |
} | Closes a block started by { above. |
How it works (big picture)
- hidden input passes courseId as FormData.
- Server Action receives formData.get("courseId").
- No onSubmit fetch needed for the basic flow.
Do this on your computer
- Build enroll form with Server Action
- Add pending UI with useFormStatus in a child Client button
- Try submit with JS disabled in browser devtools
- Add a textarea contact form on /support
- Read the real-world section and name which part of LearnHub uses this topic.
- Run the example locally with npm run dev and confirm the same behavior.
- Change one value in the example (route, text, or course id) and predict what will happen before you save.
Experiments — try changing this
- Change a string or route in the example and save — watch the browser update.
- Break the code on purpose (remove a bracket), read the error overlay, then fix it.
Remember
form action wires to Server Actions. name attributes map to FormData keys. Enhance with Client Components for UX.
Common questions
Controlled inputs with Server Actions?
Use useFormState or client state for complex multi-step wizards.
How long should I spend on Forms in Next.js?
Until you can explain it in your own words and run the example without looking at the answer. Beginners often need 30–60 minutes per new concept; setup lessons may take one afternoon.
What if I get stuck on Forms in Next.js?
Re-read the line-by-line walkthrough, check the terminal and browser overlay for errors, and compare your code character-by-character with the example. Search the exact error text — someone else had it too.
Where is Forms in Next.js used in real jobs?
See the real-world section above — the same pattern appears in LMS, e-commerce, SaaS, and dashboards. Interviewers ask you to explain it using one concrete example.