You get the error "Operation not permitted on a capped collection". What might be the issue?

The error "Operation not permitted on a capped collection" in MongoDB means you're trying to perform an operation that is not allowed on a capped collection — a special type of collection with strict constraints.

🧾 What Is a Capped Collection?

A capped collection in MongoDB is:

• Fixed-size (in bytes or number of documents).

• FIFO (First-In-First-Out) — old documents are automatically overwritten when the size limit is reached.

• Insert-only — documents are inserted in the order received and are not allowed to be deleted or modified in a way that changes their size.

⚠️ Common Causes of This Error

1. Trying to Delete Documents

Capped collections do not allow deletes:

db.cappedCollection.deleteOne({ status: "inactive" })
// ❌ Throws: Operation not permitted on a capped collection

2. Trying to Update Documents to a Larger Size

You cannot increase the size of a document in a capped collection:

db.cappedCollection.updateOne(
  { _id: 1 },
  { $set: { longText: "new large content that increases size" } }
)
// ❌ Throws the same error

3. Running Unsupported Operations

Some operations like remove(), certain update() forms, and findAndModify() with document resizing are disallowed.

✅ How to Fix It

✅ 1. Avoid Deletes or Size-Increasing Updates

• Only use inserts or in-place updates that do not increase the document size.

• Keep document structure fixed.

Example of a safe update:

db.cappedCollection.updateOne(
  { _id: 1 },
  { $set: { status: "active" } }  // Only changing value, not increasing size
)

✅ 2. Use a Non-Capped Collection If You Need Flexibility

If you need to:

• Delete documents

• Grow documents

• Perform flexible queries and updates

Then convert to a normal collection.

You can't un-cap a collection, but you can do this:

// Step 1: Create a new normal collection
db.createCollection("newCollection")

// Step 2: Copy data over
db.cappedCollection.find().forEach(doc => db.newCollection.insert(doc))

// Step 3: Drop the capped collection (if needed)
db.cappedCollection.drop()

✅ 3. Check If Collection Is Capped

Use this command:

db.collectionName.isCapped()

Returns true if the collection is capped.

🧠 Summary Table

Action	Capped Collection Allowed?
Insert	✅ Yes
In-place update (no size change)	✅ Yes
Update that increases size	❌ No
Delete documents	❌ No
remove() or deleteOne()	❌ No