NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4415 most downloaded on npm
Mongoose MongoDB ODM
Latest stable
9.12.2
Last release 6 days ago
16 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 55 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
16 years old
1038 releases · first in 2010
Drag across the ruler to compare, or tap a release to open it.
fix(schema): allow 0 for numbers if required and ref both set #11912
UpdateFilter #11911feat: upgrade mongodb driver -> 4.7.0 #11909 AbdelrahmanHafez
Your coding agent can read these notes before it upgrades. Set up the MCP server →
transform option to lean() #10423 IslandRhythmson from schema reserved keys #11580 IslandRhythmsfix(document): handle nested paths underneath subdocuments when getting all subdocuments for pre save hooks #11917
fix: revert 670b445b0fc perf optimizations that caused some test failures #11541
Nothing published for this version
fix(update): apply timestamps to nested subdocs within $push and $addToSet #11775
toObject() options #11776fix(document): avoid infinite recursion when calling toObject() on self-referencing document #11756
fix(schema): disallow using schemas with schema-level projection with map subdocuments #11698
distinct() and hint with findOneAndUpdate() #11793deleteModel() with RegExp in TypeScript #11812perf: avoid leaking memory when using populate() with QueryCursor because of reusing populate options with _docs #11641
_docs #11641_id back for LeanDocument #11769 #11761 taxilianinsertOne and replaceOne #11663perf: avoid registering event listeners on subdocuments to reduce memory usage #11541
perf: improve perf of key order #11639 Uzlopak
ref #11538createCollection() #11539extends Document #11629fix: upgrade mongodb driver -> 4.5.0 #11623 AbdelrahmanHafez
removeIndex() and clearIndex() #11547 IslandRhythmscontinueOnError option to allow executing eachAsync() on all docs even if error occurs #6355versionKey option to lean() for removing version key from lean docs #8934 IslandRhythmsfix(document): handle validation with triply nested document arrays #11564
docs(typescript): add note about deprecating extends Document #11619 AbdelrahmanHafez
perf(document+model): make a few small optimizations #11380
expires option #11557 boly38refPath example #11565 chandiwalaaadhardocs(migrating_to_6): describe breaking change in Mongoose 6 about default query populate model #11289
this = any in middleware #11435perf(document): avoid running validation on every array element if there's no validators to run #11380
fix(types): correct reference to cursor TypeScript bindings #11513 SimonHausdorf
fix(mongoose): add isObjectIdOrHexString() to better capture the most common use case for isValidObjectId() #11419
isValidObjectId() #11419$set #11456localField and foreignField functions #11321{ field: 'asc'|'ascending'|'desc'|'descending' } #11479 simonbrunelQuery.prototype.populate() a string #11475 minhthinhlsdocs(migrating_to_6): add model.exists breaking change returning doument instead of boolean #11407 AbdelrahmanHafez
pick() #11448 Moisei-Shkildocs(migrating_to_6): add model.exists breaking change returning doument instead of boolean AbdelrahmanHafez
Connection.prototype.syncIndexes() #11424 #11421 AbdelrahmanHafez[{ type: [String] }] #11252errors only contains CastError or ValidationError #11369 UzlopaksupressReservedKeysWarning option to schema #11439 hiukkyerr.reason.servers #11200true for toJSON() but not toObject() #11213fix: fix QueryCursor and AggregationCursor compatibility with Node v17.5 #11381 benjamingr
get() helper where possible #11389 UzlopakisArray() instead of instanceof Array #11393 Uzlopakcast$expr() #11388 UzlopakstartsWith() from isOperator() #11400 UzlopakPipelineStage into separate file #11368 Uzlopakperf: improve performance especially of validate and clone #11298 Uzlopak
collection() for integration with MongoDB Node driver's collection class #11131feat(connection+mongoose): add support for continueOnError for syncIndexes #11266 AbdelrahmanHafez
$expr where possible #10663bulkSave() type def #11201 Uzlopakfix(mongoose): correctly handle destructured isValidObjectId #11304
isValidObjectId() #11227Nothing published for this version
fix(connection): stop leaking sessions in .transaction() #11259 #11256 Uzlopak
findOne().populate() result non-nullable #11041fix(model): correct handling for $push on a nested array #11108
skipInit #11137fix(model): revert #11079: findByIdAndUpdate(undefined) breaking change #11149
bulkSave() error when versionKey: false #11186 #11071 IslandRhythmsfindByIdAndUpdate(undefined) breaking change #11149connect() options #11184 splinterperf(index.d.ts): simplify Schema typedef for query helpers and methods to significantly reduce TS compiler overhead #10349
$group pipeline stage #11140 #11067 EugeneKorshenkofix(document): handle save with undefined nested doc under subdoc #11110
create() #10856populate() #11027strictQuery example #11135 MontgomeryWattsperf(populate): avoid duplicate model names when using refPath to avoid O(n^2) memory growth with number of array elements #10983
setClient() when disconnected #11114 hustxiaocfix: upgrade mongodb driver to 4.2.2 #11092 lorand-horvath
useDb() #11003Query.prototype.countDocuments() #11037Query.prototype.tailable() #10875fix(document): allow setting nested path to instance of document #11011
Model.schema #10895new #10960feat(populate): support ref on subdocuments #10856
ownerDocument() method to top-level document for consistency with subdocs #10884 IslandRhythmstimeseries option for MongoDB 5 time series collections support #10611strictPopulate option #10694 IslandRhythmsmongoose.syncIndexes() and Connection.prototype.syncIndexes() #10893 IslandRhythmsNothing published for this version
Nothing published for this version
Nothing published for this version
fix(cursor): remove the logic for emitting close, rely on autoDestroy option for Node 12 support #10906 iovanom
toJSON() flatten maps by default in TypeScript #10872SchemaType.prototype.set() #10799updateMany() and deleteMany() docs to reflect new matchedCount, modifiedCount, deletedCount properties #10908 IslandRhythmsNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.