countDocuments method in MongoDB

Introduction

The countDocuments method helps you find out how many documents match a certain condition in a MongoDB collection. It's like counting how many items fit your search.

You want to know how many users have signed up with a specific email domain.

You need to count how many orders were placed in the last month.

You want to check how many products are currently in stock.

You want to find out how many blog posts have a certain tag.

You want to count how many customers live in a particular city.

Syntax

MongoDB

db.collection.countDocuments(filter, options)

filter is where you specify the condition to match documents.

options is optional and can include settings like limit or skip.

Examples

Counts how many users are 18 years old or older.

MongoDB

db.users.countDocuments({ age: { $gte: 18 } })

Counts how many orders have the status "shipped".

MongoDB

db.orders.countDocuments({ status: "shipped" })

Counts up to 100 products in the "books" category.

MongoDB

db.products.countDocuments({ category: "books" }, { limit: 100 })

Sample Program

This query switches to the shopDB database and counts all customers whose city is "New York".

MongoDB

use shopDB

// Count how many customers live in 'New York'
db.customers.countDocuments({ city: "New York" })

Important Notes

countDocuments only counts documents that match the filter exactly.

It is more accurate than estimatedDocumentCount() when you use filters.

If you want to count all documents without a filter, you can call countDocuments({}).

Summary

countDocuments tells you how many documents match your search.

You give it a filter to specify what to count.

It helps you quickly get counts without fetching all data.

Practice

1.

What does the countDocuments method do in MongoDB?

easy

A. Counts how many documents match a given filter

B. Deletes documents matching a filter

C. Updates documents matching a filter

D. Returns all documents in a collection

Solution

1. Step 1: Understand the purpose of countDocuments

   The countDocuments method is used to count documents that match a filter in a collection.

2. Step 2: Compare with other operations

   Deleting, updating, or returning documents are different operations and not related to counting.

3. Final Answer:

   Counts how many documents match a given filter -> Option A

4. Quick Check:

   countDocuments = count matching documents [OK]

Hint: Remember: countDocuments counts, not modifies data [OK]

Common Mistakes:

• Confusing countDocuments with delete or update methods
• Thinking it returns the documents instead of a count
• Assuming it counts all documents without a filter

2.

Which of the following is the correct syntax to count documents with status equal to "active" in a collection named users?

?

easy

A. db.users.countDocuments({ status: "active" })

B. db.users.count({ status: active })

C. db.users.find({ status: "active" }).countDocuments({ status: "active" })

D. db.users.countDocuments("status = active")

Solution

1. Step 1: Identify correct method usage

   The countDocuments method is called on the collection with a filter object inside parentheses.

2. Step 2: Check filter format

   The filter must be an object like { status: "active" }, not a string or chained after find().

3. Final Answer:

   db.users.countDocuments({ status: "active" }) -> Option A

4. Quick Check:

   Correct syntax uses countDocuments(filter) [OK]

Hint: Use countDocuments with a filter object inside parentheses [OK]

Common Mistakes:

• Using deprecated count() method
• Passing filter as a string instead of object
• Calling countDocuments after find()

3.

Given the collection orders with documents:

[{ "status": "shipped" }, { "status": "pending" }, { "status": "shipped" }]

What will db.orders.countDocuments({ status: "shipped" }) return?

medium

A. 1

B. 0

C. 2

D. 3

Solution

1. Step 1: Identify documents matching the filter

   Documents with status: "shipped" are the first and third documents.

2. Step 2: Count matching documents

   There are 2 such documents in total.

3. Final Answer:

   2 -> Option C

4. Quick Check:

   Count of shipped orders = 2 [OK]

Hint: Count documents matching filter exactly [OK]

Common Mistakes:

• Counting all documents instead of filtered ones
• Misreading the status values
• Assuming countDocuments returns documents, not count

4.

What is wrong with this code snippet?

const count = db.products.countDocuments("category: 'books'");

It aims to count documents where category is "books".

medium

A. Missing await keyword for asynchronous call

B. The filter is passed as a string instead of an object

C. countDocuments cannot be used on the products collection

D. The method name should be count, not countDocuments

Solution

1. Step 1: Check filter argument type

   The filter must be an object like { category: 'books' }, not a string.

2. Step 2: Confirm method usage

   countDocuments is valid on collections and accepts an object filter.

3. Final Answer:

   The filter is passed as a string instead of an object -> Option B

4. Quick Check:

   Filter must be an object, not a string [OK]

Hint: Filters are objects, not strings in countDocuments [OK]

Common Mistakes:

• Passing filter as a string
• Confusing countDocuments with count
• Ignoring async/await in some environments (not always error)

5.

You want to count how many users have either age greater than 30 or status equal to "active". Which query correctly uses countDocuments to do this?

hard

A. db.users.countDocuments({ age > 30 || status == "active" })

B. db.users.countDocuments({ age: { $gt: 30 }, status: "active" })

C. db.users.countDocuments({ $and: [ { age: { $gt: 30 } }, { status: "active" } ] })

D. db.users.countDocuments({ $or: [ { age: { $gt: 30 } }, { status: "active" } ] })

Solution

1. Step 1: Understand the filter logic

   We want documents where age is greater than 30 OR status is "active".

2. Step 2: Use correct MongoDB query syntax

   The $or operator takes an array of conditions to match either one.

3. Step 3: Check each option

   The option using { $or: [ { age: { $gt: 30 } }, { status: "active" } ] } is correct. The option with comma-separated conditions uses implicit AND, the one with $and uses explicit AND, and the last uses invalid syntax.

4. Final Answer:

   db.users.countDocuments({ $or: [ { age: { $gt: 30 } }, { status: "active" } ] }) -> Option D

5. Quick Check:

   Use $or with array for OR conditions [OK]

Hint: Use $or with array for OR conditions in filters [OK]

Common Mistakes:

• Using implicit AND instead of OR
• Writing invalid filter syntax
• Confusing $and and $or operators