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

7.6.19 Oct 2023Deprecated
fix: raw result deprecation message #13954 simllll
7.6.1 / 2023-10-09

fix: bump bson to match mongodb@5.9.0 exactly #13947 hasezoey

fix: raw result deprecation message #13954 simllll

type: add types for includeResultMetadata #13955 simllll

perf(npmignore): ignore newer files #13946 hasezoey

perf: move mocha config from package.json to mocharc #13948 hasezoey
Open source →
7.6.06 Oct 2023
feat: upgrade mongodb node driver -> 5.9.0 #13927 #13926 sanguineti
7.6.0 / 2023-10-06

feat: upgrade mongodb node driver -> 5.9.0 #13927 #13926 sanguineti

fix: avoid CastError when passing different value of discriminator key in $or #13938 #13906

7.5.44 Oct 2023

fix: avoid stripping out id property when _id is set #13933 #13892 #13867

7.5.4 / 2023-10-04

fix: avoid stripping out id property when _id is set #13933 #13892 #13867
fix(QueryCursor): avoid double-applying schema paths so you can include select: false fields with + projection using cursors #13932 #13773
fix(query): allow deselecting discriminator key using - syntax #13929 #13760
fix(query): handle $round in $expr as array #13928 #13881
fix(document): call pre('validate') hooks when modifying a path underneath triply nested subdoc #13912 #13876
fix(mongoose): correctly handle global applyPluginsToChildSchemas option #13911 #13887
types: add insertMany array overload with options #13931 t1bb4r
docs(compatibility): add Mongoose 7 support to compatibility matrix #13875
docs: amend some awkward FAQ wording #13925 peteboere

Open source →

7.5.325 Sept 2023Deprecated

docs(deprecations): fix typo in includeResultMetadata deprecation docs #13884 #13844

7.5.3 / 2023-09-25

fix(document): handle MongoDB Long when casting BigInts #13869 #13791
fix(model): make bulkSave() persist changes that happen in pre('save') middleware #13885 #13799
fix: handle casting $elemMatch underneath $not underneath another $elemMatch #13893 #13880
fix(model): make bulkWrite casting respect global setDefaultsOnInsert #13870 #13823
fix(document): handle default values for discriminator key with embedded discriminators #13891 #13835
fix: account for null values when assigning isNew property within document array #13883
types: avoid "interface can only extend object types with statically known members" error in TypeScript 4 #13871
docs(deprecations): fix typo in includeResultMetadata deprecation docs #13884 #13844
docs: fix pre element overflow in home page #13868 ghoshRitesh12

Open source →

7.5.215 Sept 2023

fix(schema): handle number discriminator keys when using Schema.prototype.discriminator() #13858 #13788

7.5.2 / 2023-09-15

fix(schema): handle number discriminator keys when using Schema.prototype.discriminator() #13858 #13788
fix: ignore id property when calling set() with both id and _id specified to avoid id setter overwriting #13762
types: pass correct document type to required and default function #13851 #13797
docs(model): add examples of using diffIndexes() to syncIndexes()and diffIndexes() api docs #13850 #13771

Open source →

7.5.111 Sept 2023Deprecated

docs(model): replace outdated docs on deprecated findOneAndUpdate() overwrite option #13821 #13715

7.5.1 / 2023-09-11

fix: set default value for _update when no update object is provided and versionKey is set to false #13795 #13783 MohOraby
fix: avoid unexpected error when accessing null array element on discriminator array when populating #13716 ZSabakh
types(schematypes): use DocType for instance method this #13822 #13800 pshaddel
types: remove duplicated 'exists' method in Model interface in models.d.ts #13818 ohzeno
docs(model): replace outdated docs on deprecated findOneAndUpdate() overwrite option #13821 #13715
docs: add example of using virtuals.pathsToSkip option for toObject() and toJSON() #13798 RobertHunter-Pluto

Open source →

7.5.029 Aug 2023Deprecated

feat: deprecate overwrite option for findOneAndUpdate() #13578

7.5.0 / 2023-08-29

feat: use mongodb driver v5.18.1
feat: allow top level dollar keys with findOneAndUpdate(), update() for MongoDB 5 #13786
fix(document): make array getters avoid unintentionally modifying array, defer getters until index access instead #13774
feat: deprecate overwrite option for findOneAndUpdate() #13578
feat: add pathsToSkip option for Model.validate #13663 #10353
feat: support alias when declaring index #13659 #13276
fix(query): remove unnecessary check for atomic operators in findOneAndReplace() #13678
types: add SearchMeta Interface for Atlas Search #13792 mreouven
types(schematypes): add missing BigInt SchemaType #13787

Open source →

7.4.525 Aug 2023

fix(debug): avoid putting virtuals and getters in debug output #13778

7.4.5 / 2023-08-25

fix(debug): avoid putting virtuals and getters in debug output #13778
fix(model): make Model.bulkWrite() with empty array and ordered false not throw an error #13664
fix(document): correctly handle inclusive/exclusive projections when applying subdocument defaults #13763 #13720

Open source →

7.4.422 Aug 2023

fix(connection): reset document state in between transaction retries #13726 #13698

7.4.4 / 2023-08-22

fix(connection): reset document state in between transaction retries #13726 #13698
fix(cursor): bubble up resumeTokenChanged event from change streams #13736 #13607
fix(query+populate): add refPath to projection by default, unless explicitly excluded #13758
fix(schema): support 'ascending', 'asc', 'descending', 'desc' for index direction #13761 #13725
fix(ChangeStream): add _bindEvents to addListener function for observable support #13759 yury-ivaniutsenka
types: infer return type when using get(), markModified(), etc. with known property name literal #13739 maybesmurf
types: add missing typings for option includeResultMetadata #13747 #13746 Idnan
types: export InferSchemaType #13737
docs(middleware): clarify that query middleware applies to document by default #13734 #13713
docs: add brief note on TypeScript generic usage for embedded discriminator path() calls #13728 #10435
docs: link v7 migration guide #13742 Cooldogyum
docs(migrating_to_6): add note about incompatible packages #13733

Open source →

7.4.311 Aug 2023

fix: avoid applying map property getters when saving #13704 #13657

7.4.3 / 2023-08-11

fix: avoid applying map property getters when saving #13704 #13657
fix(query): allow deselecting discriminator key #13722 #13679
types(models+query): return lean type when passing QueryOptions with lean: true to relevant model functions like find() and findOne() #13721 #13705
types(schema): correct return type for Schema.prototype.indexes() #13718 #13702
types: allow accessing options from pre middleware #13708 #13633
types: add UpdateQueryKnownOnly type for stricter UpdateQuery type checking #13699 #13630
types(schema): support required: { isRequired: true } syntax in schema definition #13680
docs(middleware): clarify that doc.deleteOne() doesn't run query middleware currently #13707 #13669

Open source →

7.4.23 Aug 2023Deprecated

docs(deprecations): quick fix for includeResultMetadata docs #13695

7.4.2 / 2023-08-03

fix(model): avoid hanging on empty bulkWrite() with ordered: false #13684 #13664
fix: Document.prototype.isModified support for a string of keys as first parameter #13674 #13667 gastoncasini
fix: disable id virtual if alias:id set #13654 #13650
fix: support timestamps:false on bulkWrite with updateOne and updateMany #13649 #13611
docs(typescript): highlight auto type inference for methods and statics, add info on using methods with generics #13696 #12942
docs(middleware): fix old example using post('remove') #13683 #13518
docs(deprecations): quick fix for includeResultMetadata docs #13695

Open source →

7.4.124 Jul 2023

fix(document): correctly clean up nested subdocs modified state on save() #13644 #13609

7.4.1 / 2023-07-24

fix(document): correctly clean up nested subdocs modified state on save() #13644 #13609
fix(schema): avoid propagating toObject.transform and toJSON.transform option to implicitly created schemas #13634 #13599
fix: prevent schema options overwriting user defined writeConcern #13612 #13592
types: correctly handle pre('deleteOne', { document: true }) #13632
types(schema): handle type: Schema.Types.Map in TypeScript #13628
types: Add inline comment to to tell the default value of the runValidator flag in the queryOptions types #13636 omran95
docs: rework several code examples that still use callbacks #13635 #13616
docs: remove callbacks from validation description #13638 #13501

Open source →

7.4.018 Jul 2023

perf: speed up mapOfSubdocs benchmark by 4x by avoiding unnecessary O(n^2) loop in getPathsToValidate() #13614

7.4.0 / 2023-07-18

perf: speed up mapOfSubdocs benchmark by 4x by avoiding unnecessary O(n^2) loop in getPathsToValidate() #13614
feat: upgrade to MongoDB Node.js driver 5.7.0 #13591
feat: support generating custom cast error message with a function #13608 #3162
feat(query): support MongoDB driver's includeResultMetadata option for findOneAndUpdate #13584 #13539
feat(connection): add Connection.prototype.removeDb() for removing a related connection #13580 #11821
feat(query): delay converting documents into POJOs until query execution, allow querying subdocuments with defaults disabled #13522
feat(model): add option "aggregateErrors" for create() #13544 hasezoey
feat(schema): add collectionOptions option to schemas #13513
fix: move all MongoDB-specific connection logic into driver layer, add createClient() method to handle creating MongoClient #13542
fix(document): allow setting keys with dots in mixed paths underneath nested paths #13536
types: augment bson.ObjectId instead of adding on own type #13515 #12537 hasezoey
docs(guide): fix md lint #13593 hasezoey
docs: changed the code from 'await author.save()' to 'await story1.save()' #13596 SomSingh23

Open source →

7.3.26 Jul 2023

fix(model): avoid TypeError if insertMany() fails with error that does not have writeErrors property #13579 #13531

7.3.2 / 2023-07-06

fix(model): avoid TypeError if insertMany() fails with error that does not have writeErrors property #13579 #13531
fix(query): convert findOneAndUpdate to findOneAndReplace when overwrite set for backwards compat with Mongoose 6 #13572 #13550
fix(query): throw readable error when executing a Query instance without an associated model #13571 #13570
types: support mongoose.Schema.ObjectId as alias for mongoose.Schema.Types.ObjectId #13543 #13534
docs(connections): clarify that socketTimeoutMS now defaults to 0 #13576 #13537
docs(migrating_to_7): add mapReduce() removal to migration guide #13568 #13548
docs(schemas): fix typo in schemas.md #13540 Metehan-Altuntekin

Open source →

7.3.121 Jun 2023

fix(query): respect query-level strict option on findOneAndReplace() #13516 #13507

7.3.1 / 2023-06-21

fix(query): respect query-level strict option on findOneAndReplace() #13516 #13507
docs(connections): expand docs on serverSelectionTimeoutMS #13533 #12967
docs: add example of accessing save options in pre save #13498
docs(connections+faq): add info on localhost vs 127.0.0.1
docs(SchemaType): validate members are validator & message (not msg) #13521 lorand-horvath

Open source →

7.3.014 Jun 2023

feat: upgrade mongodb -> 5.6.0 #13455 lorand-horvath

7.3.0 / 2023-06-14

feat: upgrade mongodb -> 5.6.0 #13455 lorand-horvath
feat(aggregate): add Aggregate.prototype.finally() to be consistent with Promise API for TypeScript #13509
feat(schema): support selecting subset of fields to apply optimistic concurrency to #13506 #10591
feat(model): add ordered option to Model.create() #13472 #4038
feat(schema): consistently add .get() function to all SchemaType classes
feat(populate): pass virtual to match function to allow merging match options #13477 #12443
types: allow overwriting Paths in select() to tell TypeScript which fields are projected #13478 #13224
types(schema): add validateModifiedOnly as schema option #13503 #10153
docs: add note about validateModifiedOnly as a schema option #13503 #10153
docs(migrating_to_7): update migrating_to_7.md to include Model.countDocuments #13508 Climax777
docs(further_reading): remove style for "img" hasezoey

Open source →

7.2.39 Jun 2023

fix(model): ignore falsy last argument to create() for backwards compatibility #13493 #13491 #13487 MohOraby

7.2.3 / 2023-06-09

fix(model): ignore falsy last argument to create() for backwards compatibility #13493 #13491 #13487 MohOraby
types: remove generic param that's causing issues for typegoose #13494 #13482
types(aggregate): allow object syntax for $mergeObjects #13470 #13060
docs(connection): clarify how Connection.prototype.destroy() is different from close() #13475
docs(populate): fix accidental removal of text #13480
docs: add additional notes for Atlas X.509 authentication #13452 alexbevi
docs(populate): add a little more info on why we recommend using ObjectId for _id #13474 #13400

Open source →

7.2.230 May 2023

fix(schema): make bulkWrite updateOne() and updateMany() respect timestamps option when set by merging schemas #13445

7.2.2 / 2023-05-30

fix(schema): make bulkWrite updateOne() and updateMany() respect timestamps option when set by merging schemas #13445
fix(schema): recursively copy schemas from different modules when calling new Schema() #13441 #13275
fix(update): allow setting paths with dots under non-strict paths #13450 #13434
types: improve function parameter types for ToObjectOptions transform option #13446 #13421
docs: add nextjs page with link to next starter app and couple FAQs #13444 #13430
docs(connections): add section on multi tenant #13449 #11187
docs(connection+model): expand docs on accessors for underlying collections #13448 #13334

Open source →

7.2.124 May 2023Deprecated

docs(connections): add details about keepAlive deprecation #13431

7.2.1 / 2023-05-24

fix(array): track correct changes when setting nested array of primitives #13422 #13372
fix(query): handle plus path in projection with findOneAndUpdate() #13437 #13413
fix(cursor): handle calling skipMiddlewareFunction() in pre('find') middleware with cursors #13436 #13411
fix(model): include inspect output in castBulkWrite() error #13426
fix: avoid setting null property when updating using update pipeline with child timestamps but no top-level timestamps #13427 #13379
docs: remove callback based examples #13433 #13401
docs(connections): add details about keepAlive deprecation #13431
docs: add list of supported patterns for error message templating #13425 #13311

Open source →

7.2.019 May 2023

feat(document): add flattenObjectIds option to toObject() and toJSON() #13383 #13341

7.2.0 / 2023-05-19

feat: upgrade mongodb -> 5.5.0
feat(document): add flattenObjectIds option to toObject() and toJSON() #13383 #13341
feat(query): add translateAliases option to automatically call translate aliases on query fields #13397 #8678 #7511
feat(schema): propagate toObject and toJSON options to implicitly created schemas #13325
feat(model): add throwOnValidationError option for opting into getting MongooseBulkWriteError if all valid operations succeed in bulkWrite() and insertMany() #13410 #13256
feat(types+mongoose): export MongooseError #13403 #13387 ramos-ph

Open source →

7.1.219 May 2023

fix: set timestamps on single nested subdoc in insertMany() #13416 #13343

7.1.2 / 2023-05-18

fix: set timestamps on single nested subdoc in insertMany() #13416 #13343
fix: mention model name in missing virtual option in getModelsMapForPopulate #13408 #13406 hasezoey
fix: custom debug function not processing all args #13418 #13364
docs: add virtuals schema options #13407 hasezoey
docs: clarify JSON.stringify() virtuals docs #13273 iatenine

Open source →

7.1.110 May 2023

fix(document): handle set() from top-level underneath a map of mixed #13386

7.1.1 / 2023-05-10

fix(document): handle set() from top-level underneath a map of mixed #13386
fix: don't modify passed options object to createConnection() #13376
types: make lean() not clobber result type for updateOne(), etc. #13389 #13382
types: handle union types in FlattenMaps #13368 #13346 Jokero
types(document): correct return type for Model.prototype.deleteOne(): promise, not query #13367 #13223
types: update document.d.ts $set function params to match set #13304 jeffersonlipsky
docs: add excludeIndexes to the guide schema options list #13377 #13287
docs: fix broken "fork me" on home page #13336

Open source →

7.1.027 Apr 2023

feat(schema): add BigInt support, upgrade mongodb -> 5.3.0 #13318 #13081 #6936

7.1.0 / 2023-04-27

feat: upgrade mongodb -> 5.3.0
feat(schema): add BigInt support, upgrade mongodb -> 5.3.0 #13318 #13081 #6936
feat: handle MongoDB's new UUID type, export mongoose.Types.UUID #13323 #13103
feat: implement createCollections() #13324
feat(query): add isPathSelectedInclusive function on query #13177
types: added overloads for Schema.pre/post with different values for SchemaPreOptions #12680 jpilgrim
types(query): make lean() flatten out inferred maps into Record<string, V> #13326 #13010
docs: update README deno url #13332
docs: update jsdoc to use full URLs instead of non-prefix absolute urls (also fix some urls) #13328 hasezoey
docs: reload api js files on change #13313 hasezoey
docs: update website sidebar to be better use-able #13321 hasezoey
docs: fix schematype @see links #13310 hasezoey
docs(subdocuments): remove callback usage, use deleteOne() rather than remove() re: #13284 #13316

Open source →

7.0.524 Apr 2023

fix(schema): correctly handle uuids with populate() #13317 #13267

7.0.5 / 2023-04-24

fix(schema): correctly handle uuids with populate() #13317 #13267
fix(schema): add clusteredIndex to schema options #13286 jakesjews
fix(document): use collection.findOne() for saving docs with no changes to avoid firing findOne middleware #13298
types(schema): avoid circular constraint in TSchemaOptions with --incremental by deferring ResolveSchemaOptions<> #13291 #13129
docs(subdocs): fix mention of subdocument ".remove" function #13312 hasezoey
docs: add mongoose.Promise removal to migrating to 7 guide #13295
docs: updated formatting of Error Handling section to better highlight the two kinds of possible errors #13279 Ankit-Mandal
docs: fix broken link #13301 #13281

Open source →

7.0.417 Apr 2023

fix(schema): fix dangling reference to virtual in tree after removeVirtual() #13255 #13085

7.0.4 / 2023-04-17

fix(schema): fix dangling reference to virtual in tree after removeVirtual() #13255 #13085
fix(query): cast query filters on findOneAndUpdate() #13220 #13219 dermasmid
types(model): aligned watch() type for mongodb 4.6.0 #13208 #13206
docs: fix async function anchors #13226 hasezoey
docs: fix schema syntax in exemple #13262 c-marc
docs: rework scripts to allow easier setting of current and past versions #13222 #13148 hasezoey

Open source →

7.0.323 Mar 2023

fix(query): avoid executing transforms if query wasn't executed #13185 #13165

7.0.3 / 2023-03-23

fix(query): avoid executing transforms if query wasn't executed #13185 #13165
fix(schema): make creating top-level virtual underneath subdocument equivalent to creating virtual on the subdocument #13197 #13189
fix(timestamps): set timestamps on empty replaceOne() #13196 #13170
fix(types): change return type of lean() to include null if nullable #13155 #13151 lpizzinidev
fix(types): fixed type of DocumentArray constructor parameter #13183 #13087 lpizzinidev
docs: refactor header naming to lessen conflicts #12901 hasezoey
docs: change header levels to be consistent across files #13173 hasezoey

Open source →

7.0.215 Mar 2023

fix: validate array elements when passing array path to validateSync() in pathsToValidate #13167 #13159

7.0.2 / 2023-03-15

fix: validate array elements when passing array path to validateSync() in pathsToValidate #13167 #13159
fix(schema): propagate typeKey down to implicitly created subdocuments #13164 #13154
fix(types): add index param to eachAsync fn #13153 krosenk729
fix(types/documentarray): type DocumentArray constructor parameter as object #13089 #13087 lpizzinidev
fix(types): type query select() as string, string[], or record; not any #13146 #13142 rbereziuk
fix(types/query): change QueryOptions lean type to Record<string, any> #13150 lpizzinidev
docs: add and run eslint-plugin-markdown #13156 hasezoey
docs(generateSearch): fix search generation for API #13161 hasezoey
docs(generateSearch): move config missing error to require #13160 hasezoey
chore: remove unused docs libraries #13172 hasezoey

Open source →

7.0.16 Mar 2023

fix(aggregate): added await to prevent exception in aggregate exec #13126 lpizzinidev

7.0.1 / 2023-03-06

fix(aggregate): added await to prevent exception in aggregate exec #13126 lpizzinidev
fix(types): handle Record<string, never> as value for HydratedDocument TOverrides parameter #13123 #13094
fix(types): remove "update" function #13120 hasezoey
docs(compatibility): added mongoDB server compatibility for mongoose 7 #13102 lpizzinidev
docs: Updated callback method for Model.findOne() #13096 Arghyahub
chore: update github actions to not use ubuntu-18.04 anymore #13137 hasezoey

Open source →

7.0.027 Feb 2023Breaking

BREAKING CHANGE: copy schema options when merging schemas using new Schema() or Schema.prototype.add() #13092

7.0.0 / 2023-02-27

BREAKING CHANGE: copy schema options when merging schemas using new Schema() or Schema.prototype.add() #13092
feat(types): export mongodb types more robustly #12948 simon-abbott
docs: fix populate docs #13090 hasezoey
docs(migrating_to_6): added info about removal of reconnectTries and reconnectInterval options #13083 lpizzinidev

Open source →

7.0.0-rc023 Feb 2023pre-releaseBreaking

BREAKING CHANGE: remove support for callbacks #11431

7.0.0-rc0 / 2023-02-23

BREAKING CHANGE: remove support for callbacks #11431
BREAKING CHANGE: upgrade to MongoDB node driver 5.x, bson 5.x #12955
BREAKING CHANGE: make strictQuery: false by default #11861 #11807 #11514
BREAKING CHANGE: remove support for setting schema path definitions to primitives, except _id: false #12832 #7558 lpizzinidev
BREAKING CHANGE: discriminator schemas now inherit base schema options by default #12928 #12135
BREAKING CHANGE: orFail() now throws on updateOne() and updateMany() if matchedCount === 0, not modifiedCount === 0 #11620
BREAKING CHANGE: remove support for custom promise libraries #12878 #12872 lpizzinidev
BREAKING CHANGE: select('name -path') behaves as select('name') if path has schema-level select: true #11694
BREAKING CHANGE(types): remove support for document interfaces that extends Document #11615
BREAKING CHANGE: pluralize 'human' as 'humans', not 'humen' #13037
BREAKING CHANGE: renamed schema option supressReservedKeysWarning -> suppressReservedKeysWarning #11495
BREAKING CHANGE: remove unused DisconnectedError #13028 lpizzinidev
BREAKING CHANGE: remove unsupported query options maxScan and snapshot #13023 #13022 hasezoey

Open source →

6.13.94 Feb 2026

fix: handle other top-level query operators in sanitizeFilter

6.13.9 / 2026-02-04

fix: handle other top-level query operators in sanitizeFilter
types(aggregate): add $firstN, $lastN, $bottom, $bottomN, $minN and $maxN operators #15303 #15299
docs(compatibility): add note that Mongoose ^6.5 works with MongoDB server 7.x #15427

Open source →

mongoose

Release timeline

Releases

7.6.1 / 2023-10-09

7.6.0 / 2023-10-06

7.5.4 / 2023-10-04

7.5.3 / 2023-09-25

7.5.2 / 2023-09-15

7.5.1 / 2023-09-11

7.5.0 / 2023-08-29

7.4.5 / 2023-08-25

7.4.4 / 2023-08-22

7.4.3 / 2023-08-11

7.4.2 / 2023-08-03

7.4.1 / 2023-07-24

7.4.0 / 2023-07-18

7.3.4 / 2023-07-12

7.3.3 / 2023-07-10

7.3.2 / 2023-07-06

7.3.1 / 2023-06-21

7.3.0 / 2023-06-14

7.2.4 / 2023-06-12

7.2.3 / 2023-06-09

7.2.2 / 2023-05-30

7.2.1 / 2023-05-24

7.2.0 / 2023-05-19

7.1.2 / 2023-05-18

7.1.1 / 2023-05-10

7.1.0 / 2023-04-27

7.0.5 / 2023-04-24

7.0.4 / 2023-04-17

7.0.3 / 2023-03-23

7.0.2 / 2023-03-15

7.0.1 / 2023-03-06

7.0.0 / 2023-02-27

7.0.0-rc0 / 2023-02-23

6.13.11 / 2026-08-10

6.13.9 / 2026-02-04

6.13.8 / 2025-01-20

6.13.7 / 2025-01-20

6.13.6 / 2025-01-13