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 3 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: cast using overwritten embedded discriminator key when set #15076 #15051
fix: disallow using $where in match
fix(model): handle array filters when casting bulkWrite #15036 #14978
Your coding agent can read these notes before it upgrades. Set up the MCP server →
perf: make a few micro-optimizations to help speed up findOne() #15022 #14906
feat: upgrade mongodb -> ~6.10 #14991 #14877
__v to lean() result type and ModifyResult #14990 #12959fix(cursor): close underlying query cursor when calling destroy() #14982 #14966
fix(document): recursively clear modified subpaths when setting deeply nested subdoc to null #14963 #14952
fix: set flattenObjectIds to false when calling toObject() for internal purposes #14938
feat(model): add Model.applyVirtuals() to apply virtuals to a POJO #14905 #14818
fix(document): avoid massive perf degradation when saving new doc with 10 level deep subdocs #14910 #14897
fix: make getters convert uuid to string when calling toObject() and toJSON() #14890 #14869
fix: make set merge deeply nested objects #14870 #14861 ianHeydoc
fix(document): avoid unnecessary clone() in applyGetters() that was preventing getters from running on 3-level deep subdocuments #14844 #14840 #14835
feat: upgrade mongodb -> 6.8.0, handle throwing error on closed cursor in Mongoose with MongooseError instead of MongoCursorExhaustedError #14813
MongooseError instead of MongoCursorExhaustedError #14813fix(populate): fix a couple of other places where Mongoose gets the document's _id with getters #14833 #14827 #14759
fix: add empty string check for collection name passed #14806 Shubham2552
fix(document): call required functions on subdocuments underneath nested paths with correct context #14801 #14788
lean() set #14799 #14794 #14759 MohOrabyperf(clone): avoid further unnecessary checks if cloning a primitive value #14762 #14394
perf(model): performance improvements for insertMany() #14724
perf: memoize toJSON / toObject default options #14672
types: correct this for validate.validator schematype option #14720 #14696
perf: avoid unnecesary get() call and use faster approach for converting to string #14673 #14394
fix: remove 0x flamegraph files from release
perf: more toObject() perf improvements #14623 #14606 #14394
fix: pass options to clone instead of get in applyVirtuals #14606 #14543 andrews05
feat: upgrade mongodb -> 6.6.2 #14584
fix(query): shallow clone $or, $and if merging onto empty query filter #14580 #14567
perf(document): avoid cloning options using spread operator for perf reasons #14565 #14394
perf(document): add fast path for applying non-nested virtuals to JSON #14543
fix(populate): avoid match function filtering out null values in populate result #14518 #14494
fix(document): make update minimization unset property rather than setting to null #14504 #14445
feat(document): add validateAllPaths option to validate() and validateSync() #14467 #14414
types(query): bring "getFilter" and "getQuery" in-line with "find" and other types #14463 hasezoey
fix(schema): avoid returning string 'nested' as schematype #14453 #14443 #14435
fix(model): improve update minimizing to only minimize top-level properties in the update #14437 #14420 #13782
fix(document): make $clone avoid converting subdocs into POJOs #14395 #14353
feat(model): add recompileSchema() function to models to allow applying schema changes after compiling #14306 #14296
hydratedPopulatedDocs option to make hydrate recursively hydrate populated docs #14352 #4727fix: avoid corrupting $set-ed arrays when transaction error occurs #14346 #14340
toObject.versionKey set to false #14344fix: include virtuals in document array toString() output if toObject.virtuals set #14335 #14315
createCollections() #14295 #14279fix(model): throw readable error when calling Model() with a string instead of model() #14288 #14281
feat: upgrade MongoDB driver -> 6.3.0 #14241 #14189 #14108 #14104
docs: update TLS/SSL guide for Mongoose v8 - MongoDB v6 driver deprecations #14170 andylwelch
fix(schema): avoid creating unnecessary clone of schematype in nested array so nested document arrays use correct constructor #14128 #14101
refPath and ref functions #14133 #13834types(document): correct return type for doc.deleteOne() re: Mongoose 8 breaking change #14110 #14081
fix: retain key order with aliases when creating indexes with alias #14042 meabed
this parameter for methods and statics #14028 #14027 ruxxzebredocs: add version support notes for Mongoose 8, including EOL date for Mongoose 6
BREAKING CHANGE: use MongoDB node driver 6, drop support for rawResult option and findOneAndRemove() #13753
id setter #13784Model.count(), Query.prototype.count() #13618 #13598mongoose/lib/mongoose.js file to allow importing Mongoose without MongoDB driver #13905null for optional fields #13901Nothing published for this version
Nothing published for this version
fix(query): apply sanitizeFilter in countDocuments and cursor
fix(utils): allow merging single nested paths and document array paths outside of discriminator schema merges #16351 #9534
fix(document): add additional defensive checks for special properties in Document.prototype.get()
Nothing published for this version
fix(bulkWrite): pass overwriteImmutable option to castUpdate fixes #15789 #15782 #15781
types(aggregate): allow calling project() with a string #15304 #15300
chore: remove coverage output from bundle
chore: re-release to force npm audit to pick up 6.x fix for CVE-2025-23061
fix: disallow nested $where in populate match
fix: disallow using $where in match
Nothing published for this version
One column per quarter.