npm · #4415 most downloaded on npm

mongoose

9.10.428M downloads/moAutomattic/mongoose ↗New releases in your daily digest, changelog included.

Mongoose MongoDB ODM

Last release today
04 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
4 versions withdrawn
withdrawn after publishing
16 years old
1021 releases · first in 2010

Release timeline

1021 releases since 2010

20102012201420162018

Releases

6.2.611 Mar 2022
fix(types): correct reference to cursor TypeScript bindings #11513 SimonHausdorf
6.2.6 / 2022-03-11

fix(types): correct reference to cursor TypeScript bindings #11513 SimonHausdorf

fix(types): allow calling Query.prototype.populate() with array of strings #11518

fix(types): export and refactor types of PreMiddlewareFunction, PreSaveMiddlewareFunction, PostMiddlewareFunction, ErrorHandlingMiddlewareFunction #11485 Uzlopak
Open source →
6.2.59 Mar 2022
fix(mongoose): add isObjectIdOrHexString() to better capture the most common use case for isValidObjectId() #11419
6.2.5 / 2022-03-09

fix(mongoose): add isObjectIdOrHexString() to better capture the most common use case for isValidObjectId() #11419

fix(query): prevent modifying discriminator key in updates using operators other than $set #11456

fix(populate+types): call foreignField functions with doc as 1st param, better typings for localField and foreignField functions #11321

fix(populate): return an array when using populate count on an array localField #11307

fix(query): avoid error when using $not with arrays #11467

perf: only deep clone validators if necessary #11412 Uzlopak

fix(types): rename definition files to lowercase to avoid typescript bug #11469

fix(types): aggregate.sort() accepts a string but also { field: 'asc'|'ascending'|'desc'|'descending' } #11479 simonbrunel

fix(types): extract and refactor aggregationcursor and querycursor #11488 Uzlopak

fix(types): extract and refactor schemaoptions #11484 Uzlopak

fix(types): make first param to Query.prototype.populate() a string #11475 minhthinhls

fix(types): improve type checking for doc arrays in schema definitions #11241

docs: fix length comparaison in lean.test.js #11493 zazapeta

docs(timestamps): fix typo #11481 saibbyweb

docs: fix broken link to rawResult #11459 chhiring90

6.2.428 Feb 2022Breaking

docs(migrating_to_6): add model.exists breaking change returning doument instead of boolean #11407 AbdelrahmanHafez

6.2.4 / 2022-02-28

fix(query): correctly return full deleteOne(), deleteMany() result #11211
fix(query): handle update validators on deeply nested subdocuments #11455 #11394
fix(discriminator): handle modifying multiple nested paths underneath a discriminator #11428
perf: improve isAsyncFunction #11408 Uzlopak
fix(index.d.ts): add typedefs for Schema pick() #11448 Moisei-Shkil
fix(index.d.ts): allow type override for distinct() #11306
fix(index.d.ts): allow array of validators in schema definition #11355
fix(index.d.ts): improve connection typings #11418 Uzlopak
docs: add timestamps docs #11336
docs(timestamps): explain how timestamps works under the hood #11336
docs(migrating_to_6): add model.exists breaking change returning doument instead of boolean #11407 AbdelrahmanHafez
docs(index.d.ts): add docs for FilterQuery, UpdateQuery, and LeanDocument #11457 Moisei-Shkil

Open source →

6.2.321 Feb 2022Breaking

docs(migrating_to_6): add model.exists breaking change returning doument instead of boolean AbdelrahmanHafez

6.2.3 / 2022-02-21

fix(model): avoid dropping base model indexes when using discriminators with Connection.prototype.syncIndexes() #11424 #11421 AbdelrahmanHafez
fix(document): handle array defaults when selecting element underneath array #11376
fix(populate): correctly handle depopulating populated subdocuments #11436
fix(utils): improve deepEqual() handling for comparing objects with non-objects #11417
fix(schema): allow declaring array of arrays using [{ type: [String] }] #11252
perf: improve validation sync and async by replacing forEach with classic for loops #11414 Uzlopak
perf: make hasDollarKeys faster #11401 Uzlopak
fix(index.d.ts): ValidationError errors only contains CastError or ValidationError #11369 Uzlopak
fix(index.d.ts): make InsertManyResult.insertedIds return an array of Types.ObjectId by default #11197
fix(index.d.ts): allow pre('save') middleware with pre options #11257
fix(index.d.ts): add supressReservedKeysWarning option to schema #11439 hiukky
docs(connections): improve replica set hostname docs with correct error message and info about err.reason.servers #11200
docs(populate): add virtual populate match option documentation #11411 remirobichet
docs(document): add note to API docs that flattenMaps defaults to true for toJSON() but not toObject() #11213
docs(document+model): add populate option to populate() API docs #11170
docs(migrating_to_6): add additional info about removing omitUndefined #11038
docs(migrating_to_6): add model.exists breaking change returning doument instead of boolean AbdelrahmanHafez

Open source →

6.2.216 Feb 2022

fix: fix QueryCursor and AggregationCursor compatibility with Node v17.5 #11381 benjamingr

6.2.2 / 2022-02-16

fix: fix QueryCursor and AggregationCursor compatibility with Node v17.5 #11381 benjamingr
fix: better esm support, no necessity for setting allowSyntheticDefaultImports and esModuleInterop #11343 Uzlopak
fix(model): apply projection parameter to hydrate() #11375
fix: fix issue with creating arrays of length > 10000 #11405 Uzlopak
fix(document): minimize single nested subdocs #11247
fix(connection): handle reopening base connection with useDb() #11240
perf: use property access instead of get() helper where possible #11389 Uzlopak
fix: use isArray() instead of instanceof Array #11393 Uzlopak
perf: improve performance of cast$expr() #11388 Uzlopak
perf: remove startsWith() from isOperator() #11400 Uzlopak
fix(index.d.ts): extract PipelineStage into separate file #11368 Uzlopak
fix(index.d.ts): fix $search highlight path option type #11373 lmX2015
docs: update changelog file to CHANGELOG.md #11365 AbdelrahmanHafez
docs: fix broken links #11388 #11377 saibbyweb
docs: remove double determiners in connections docs #11340 Erma32

Open source →

6.2.17 Feb 2022

perf: improve performance especially of validate and clone #11298 Uzlopak

6.2.1 / 2022-02-07

perf: improve performance especially of validate and clone #11298 Uzlopak
perf: remove regexp-clone #11327 Uzlopak
fix(document): handle initing nested properties in non-strict documents #11309
fix(query): cast $elemMatch underneath $all #11314
fix(populate): respect schema-level strictPopulate option #11290
fix: set default for dotted path projection #11293 noseworthy
fix(model): correctly handle writeConcern.w = 0 when saving #11300
fix(model): throw VersionError when saving with no changes and optimisticConcurrency = true #11295
fix(query): avoid adding $each to $addToSet on mixed arrays #11284
fix(index.d.ts): allow using type: [Schema.Types.ObjectId] for ObjectId arrays #11194
fix(index.d.ts): make Types.DocumentArray<> convert type to subdoc, rename TMethods -> TMethodsAndOverrides #11061
fix(index.d.ts): support passing generic to createCollection() and collection() for integration with MongoDB Node driver's collection class #11131
fix(index.d.ts): add strictPopulate to MongooseOptions #11276
docs: mark Mongoose 6 as compatible with MongoDB 4 #11320 JavaScriptBach
docs: remove documentation for useNestedStrict #11313 mark-langer
docs: add "new" to ObjectId class in aggregate.js docs #11322 JavanPoirier
chore: handle eslint configuration in .eslintrc.json #11326 Uzlopak
refactor: add parenthesis for constructors in tests #11330 apeltop

Open source →

6.2.02 Feb 2022

feat(connection+mongoose): add support for continueOnError for syncIndexes #11266 AbdelrahmanHafez

6.2.0 / 2022-02-02

feat(connection+mongoose): add support for continueOnError for syncIndexes #11266 AbdelrahmanHafez
feat(query): cast literals in $expr where possible #10663
feat(schema+mongoose): add pluginTags to allow applying global plugins to only schemas with matching tags #9780
feat(discriminator): support overwriteModels:true to reuse discriminator names #11244 #10931 IslandRhythms
feat(index.d.ts): add DocType generic param to Model functions that return queries to better support projections #11156
feat(error): export MongooseServerSelectionError #11202
feat(schematype): add validators, path, isRequired to public API and TypeScript types #11139
fix(model): make exists(...) return lean document with _id or null instead of boolean #11142 AbdelrahmanHafez
fix(model): support storing versionKey in nested paths #10980
fix(index.d.ts): add options to bulkSave() type def #11201 Uzlopak
fix(index.d.ts): better support for query projections #11210 EugeneKorshenko

Open source →

6.1.824 Jan 2022

fix(connection): stop leaking sessions in .transaction() #11259 #11256 Uzlopak

6.1.8 / 2022-01-24

fix(connection): stop leaking sessions in .transaction() #11259 #11256 Uzlopak
perf: remove sliced in favor of Array.prototype.slice() #11238 Uzlopak
perf: improve setDottedPath #11264 Uzlopak
fix(document): handle edge case where NestJS sets String.type = String, mixing up schema definitions #11199
fix: remove obsolete code after upgrading to bson4 #11265 Uzlopak
fix: remove util.isArray in favor of Array.isArray #11234 Uzlopak
fix(index.d.ts): avoid UnpackedIntersection making findOne().populate() result non-nullable #11041
docs(migration): add note to change default functions to schema #11245 AbdelrahmanHafez
docs: updated docs and issue templates for new FAQs #11171 IslandRhythms
chore: fix casting benchmark #11262 Uzlopak
chore: add mongodb-memory-server to test easier locally #11255 Uzlopak
chore: fix testing tsconfig #11243 Uzlopak
refactor: move utils.random to test folder #11239 Uzlopak

Open source →

6.1.717 Jan 2022

fix(model): correct handling for $push on a nested array #11108

6.1.7 / 2022-01-17

fix(model): correct handling for $push on a nested array #11108
fix(update): correctly apply timestamps to update pipelines #11151
fix(document): correctly handle modifying array subdocument after setting array subdocument to itself #11172
fix(index.d.ts): allow passing options to model() in place of removed skipInit #11137
fix(aggregate): allow passing verbosity to Aggregate.prototype.explain() #11144
fix(index.d.ts): avoid TypeScript inferring _id as any type with HydratedDocument #11085
docs: fix Node.js Driver compat link #11214 wesbos
docs: remove extraneous backquote #11204 joebowbeer

Open source →

6.1.610 Jan 2022Breaking

fix(model): revert #11079: findByIdAndUpdate(undefined) breaking change #11149

6.1.6 / 2022-01-10

perf(document): delay creating document event emitter until used to improve memory usage, several small improvements to improve initing docs with large arrays #10400
fix(model): avoid bulkSave() error when versionKey: false #11186 #11071 IslandRhythms
fix(model): revert #11079: findByIdAndUpdate(undefined) breaking change #11149
fix(index.d.ts): support strings in deep populate #11181 ivalduan
fix(index.d.ts): rename map() -> transform() to line up with change in v6.0 #11161
fix(index.d.ts): allow new Model<DocType>(obj) for stricter type checks #11148
fix(index.d.ts): make Schema.prototype.pre() and post() generics default to HydratedDocument<DocType> #11180
docs: improve autoCreate docs #11116
docs(schematype): add missing parameter to example #11185 kerolloz
docs(connections): use updated link to list of MongoDB Node driver connect() options #11184 splinter
docs(aggregate): fix formatting #11191 enieber
docs: fix broken link #11179 khairnarsaurabh23

Open source →

6.1.54 Jan 2022

perf(index.d.ts): simplify Schema typedef for query helpers and methods to significantly reduce TS compiler overhead #10349

6.1.5 / 2022-01-04

perf(index.d.ts): simplify Schema typedef for query helpers and methods to significantly reduce TS compiler overhead #10349
fix(document): allow populating deeply nested models as strings #11168 #11160 AbdelrahmanHafez
fix(query): allow calling limit() and skip() with a string #11017
fix(cursor): propery apply selected fields when loading discriminator docs with query cursor #11130
fix(mongoose+connection): clone schema correctly when passing instance of another Mongoose instance's Schema to Connection.prototype.model() #11047
fix(index.d.ts): handle primitives with FlattenMaps #11117
fix(index.d.ts): enforce id on lean query result type #11118
fix(index.d.ts): export facet stage type #11150 mhoc
fix(index.d.ts): correct return type of projection method #11176 EugeneKorshenko
fix(index.d.ts): additional fix for $group pipeline stage #11140 #11067 EugeneKorshenko
docs: update CONTRIBUTING.md for TS tests #11164 ahmedelshenawy25
docs: use es6 object destructuring instead of regular dot operator for accessing value in object #11147 Shivaansh-Agarwal

Open source →

6.1.427 Dec 2021

fix(document): handle save with undefined nested doc under subdoc #11110

6.1.4 / 2021-12-27

fix(document): handle save with undefined nested doc under subdoc #11110
fix(document): allow manually populating subdocument refs with create() #10856
fix(populate): handles refPath underneath map of subdocuments #9359
fix(update): throw error when calling findByIdAndUpdate with undefined id #11079 gramliu
fix(mongoose): export ConnectionStates #11133 orgads
fix(index.d.ts): unpack array when using generic type override with populate() #11027
fix(index.d.ts): fix typings in Merge stage #11132
fix(index.d.ts): PipelineStage.Merge interface definition is wrong #11109
docs(typescript): add note about Schema.Types.ObjectId vs Types.ObjectId in document definition #10949
docs(connection): clarify that "connected" and "open" are different #10886
docs(populate): correct refPath example to not use on as a schema path name #11113
docs: fix strictQuery example #11135 MontgomeryWatts

Open source →

6.1.321 Dec 2021

perf(populate): avoid duplicate model names when using refPath to avoid O(n^2) memory growth with number of array elements #10983

6.1.3 / 2021-12-21

perf(populate): avoid duplicate model names when using refPath to avoid O(n^2) memory growth with number of array elements #10983
fix(schema+model): cast paths marked with ref when hydrating #11052
fix(schema): handle default function that returns null on document arrays #11058
fix(document): clean modified paths when setting deeply nested subdocument #11060
fix(populate): report full path when throwing strictPopulate error with deep populate #10923
fix(connection): allow calling setClient() when disconnected #11114 hustxiaoc
fix(index.d.ts): fix typings in Group stage #11124 DavideViolante
fix(index.d.ts): add Mongoose.prototype.trusted() function to type defs #10957
fix(index.d.ts): allow use type string in $unset update with aggregation pipeline #11107 rpenido
fix(index.d.ts) treat _id like other fields in $project #11102
docs(migrating_to_6): add omitUndefined to Mongoose 6 migration guide #10672
docs: add MongooseDocumentArray to API docs #10998
docs: fix typo in model.js #11121 eltociear
docs: fix typo in validation.md #11103 warlock1996

Open source →

6.1.215 Dec 2021

fix: upgrade mongodb driver to 4.2.2 #11092 lorand-horvath

6.1.2 / 2021-12-14

fix: upgrade mongodb driver to 4.2.2 #11092 lorand-horvath
fix(model): respect discriminators when calling Model.watch() #11007
fix(populate): allow referencing parent connection models by name when using useDb() #11003
fix(query): support options param to Query.prototype.countDocuments() #11037
fix(query): correctly use awaitData instead of awaitdata in Query.prototype.tailable() #10875
fix(index.d.ts): fix replaceRoot type #11098 alibehroozi
fix(index.d.ts): add missing syncIndexes() definition to Mongoose global and Connection class #11065
fix(index.d.ts): add boolean type for transform option #11057 AliYusuf95
docs(model.estimatedDocumentCount): add await into example to get value from the Query #11044 olecom
docs: fix broken build from awaitdata comment #11096 medolino
docs: correct Query.prototype.transform() docs #11094 medolino

Open source →

6.1.19 Dec 2021

fix(document): allow setting nested path to instance of document #11011

6.1.1 / 2021-12-09

fix(document): allow setting nested path to instance of document #11011
fix(update): respect strict option when casting array filters #11062
fix(index.d.ts): allow SchemaTypes.Mixed for all schema definition properties to allow using union types #10900
fix(index.d.ts): correct types for Schema.prototype.obj and Model.schema #10895
docs(migrating_to_6): add note about Types.ObjectId() being a class and requiring new #10960

Open source →

6.1.07 Dec 2021

feat(populate): support ref on subdocuments #10856

6.1.0 / 2021-12-07

feat(populate): support ref on subdocuments #10856
feat(document): add ownerDocument() method to top-level document for consistency with subdocs #10884 IslandRhythms
fix: upgrade to mongodb driver 4.2.1 #11032 #10985 lorand-horvath has-n
feat(schema): support timeseries option for MongoDB 5 time series collections support #10611
feat(mongoose): add global strictPopulate option #10694 IslandRhythms
feat(mongoose+connection): add global mongoose.syncIndexes() and Connection.prototype.syncIndexes() #10893 IslandRhythms
feat(query): support removing fields from projections #10630 canac
feat(aggregate): add unionWith method to aggregate #10961 saeidasadi
fix(index.d.ts): types for aggregation pipeline stages #10971 jeremyben

Open source →

6.0.1221 Oct 2021

fix(cursor): remove the logic for emitting close, rely on autoDestroy option for Node 12 support #10906 iovanom

6.0.12 / 2021-10-21

fix(cursor): remove the logic for emitting close, rely on autoDestroy option for Node 12 support #10906 iovanom
fix(map): support passing flattenMaps: false to Map toJSON(), make toJSON() flatten maps by default in TypeScript #10872
fix: upgrade to mongodb driver 4.1.3 #10911 orgads
fix(index.d.ts): correct TS function signature for SchemaType.prototype.set() #10799
fix(index.d.ts): support implicit $in in FilterQuery #10826
fix(index.d.ts): More precise type for Schema.clone() #10899 coyotte508
fix(index.d.ts): add caster property to schema arrays and document arrays #10865
docs: update updateMany() and deleteMany() docs to reflect new matchedCount, modifiedCount, deletedCount properties #10908 IslandRhythms
docs: fix broken links to populate virtuals #10870 IslandRhythms
docs: updated docs to have returnOriginal, removed new and returnDocument #10887 IslandRhythms

Open source →

mongoose

Release timeline

Releases

6.2.6 / 2022-03-11

6.2.5 / 2022-03-09

6.2.4 / 2022-02-28

6.2.3 / 2022-02-21

6.2.2 / 2022-02-16

6.2.1 / 2022-02-07

6.2.0 / 2022-02-02

6.1.10 / 2022-02-01

6.1.8 / 2022-01-24

6.1.7 / 2022-01-17

6.1.6 / 2022-01-10

6.1.5 / 2022-01-04

6.1.4 / 2021-12-27

6.1.3 / 2021-12-21

6.1.2 / 2021-12-14

6.1.1 / 2021-12-09

6.1.0 / 2021-12-07

6.0.12 / 2021-10-21