How to Access POST Form Fields in Express

Better Stack Team
Updated on April 4, 2024

In Express.js, you can access POST form fields using the req.body object. To do this, you need to use a middleware called body-parser (for Express versions 4.16.0 and below) or the built-in express.urlencoded() middleware (for Express versions 4.16.1 and above).

Here's an example using the express.urlencoded() middleware:

  1. Install express (if not already installed) and body-parser (if your Express version is 4.16.0 or below):

    npm install express
  2. Create an Express application:

    const express = require('express');
    const app = express();
    // Middleware to parse urlencoded data
    app.use(express.urlencoded({ extended: true }));
    // Route handling POST form submission'/submit-form', (req, res) => {
      // Access form fields from req.body
      const username = req.body.username;
      const password = req.body.password;
      // Process the form data
      console.log('Username:', username);
      console.log('Password:', password);
      // Send a response
      res.send('Form submitted successfully!');
    // Start the server
    const PORT = 3000;
    app.listen(PORT, () => {
      console.log(`Server is listening on port ${PORT}`);
  3. Create an HTML form:

    <!DOCTYPE html>
    <html lang="en">
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Form Submission</title>
      <form action="/submit-form" method="post">
        <label for="username">Username:</label>
        <input type="text" id="username" name="username" required>
        <label for="password">Password:</label>
        <input type="password" id="password" name="password" required>
        <button type="submit">Submit</button>
  4. Submit the form:

    • Open the HTML file in a browser.
    • Enter values in the form fields and submit the form.

The Express server will receive the POST request, and you can access the form fields using req.body in the route handler. Make sure to use the express.urlencoded() middleware to parse the form data. If your Express version is 4.16.1 or above, this middleware is included by default. Otherwise, you might need to install and use the body-parser middleware as shown in step 1.

Make your mark

Join the writer's program

Are you a developer and love writing and sharing your knowledge with the world? Join our guest writing program and get paid for writing amazing technical guides. We'll get them to the right readers that will appreciate them.

Write for us
Writer of the month
Marin Bezhanov
Marin is a software engineer and architect with a broad range of experience working...
Build on top of Better Stack

Write a script, app or project on top of Better Stack and share it with the world. Make a public repository and share it with us at our email.

or submit a pull request and help us build better products for everyone.

See the full list of amazing projects on github