DEV Community

Antoine for Itself Tools

Posted on

Efficiently Batch Writing Documents in Firestore with Next.js

In the fast-evolving world of web development, optimizing data handling processes is crucial for performance and scalability. Today, we're discussing a powerful approach to managing data with Firestore within a Next.js environment. At, we've developed over 30 projects using Next.js and Firebase, and have gained valuable insights that we are eager to share with you.

Understanding the Code

Here is a brief explanation of what the provided Node.js code does when integrated into a Next.js API route:

// 7. API Route to batch write multiple documents in Firestore
const { db } = require('../../firebase');

export default async function handler(req, res) {
  if (req.method === 'POST') {
    const users = req.body;
    try {
      const batch = db.batch();
      users.forEach(user => {
        const docRef = db.collection('users').doc();
        batch.set(docRef, user);
      await batch.commit();
      res.status(200).json({ message: 'Batch write successful' });
    } catch (e) {
      res.status(400).json({ message: 'Batch write failed' });
  } else {
    res.setHeader('Allow', ['POST']);
    res.status(405).end(`Method ${req.method} Not Allowed`);
Enter fullscreen mode Exit fullscreen mode

Step-by-Step Breakdown

  1. Check Request Method: The server checks if the incoming request is a POST. If not, it rejects the request with a 405 Method Not Allowed status.
  2. Create a Batch Object: A batch object is created using db.batch(), allowing multiple writes to be grouped into a single transaction.
  3. Document References and Write Operations: For each user in the request body, a new document reference in the 'users' collection is created. Each user's data is then written to their respective document through the batch.set() method.
  4. Commit the Batch: The batch of writes is committed asynchronously using await batch.commit(). If successful, the operation returns a status of 200, indicating a successful batch write.
  5. Error Handling: In the event of an exception (e.g., a failed write operation), the server responds with a status of 400 and an explanatory message.

Why Use Batch Writing?

Batch writing is an efficient way to write multiple documents to Firestore simultaneously. This method reduces network requests, minimizes write operation overhead, and significantly enhances performance, especially when dealing with large sets of data.


Leveraging batch writes in Firestore within your Next.js applications can lead to more efficient, reliable, and scalable data handling. If you're interested in seeing more about how effective Firestore and Next.js can be, check out our applications like Explore Words Translated in Languages, Extract Text with OCR Free, and Record Your Screen Online for practical implementations of these technologies.

Top comments (0)