automattic/mongoose

★ 27,482JavaScriptAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((Mongoose))
    Core concepts
      Schema definition
      Model creation
      Document CRUD
    Schema features
      Validators
      Default values
      Middleware hooks
    Relationships
      Populate refs
      Virtual fields
    Runtime
      Node.js
      Deno alpha support

mindmap root((Mongoose)) Core concepts Schema definition Model creation Document CRUD Schema features Validators Default values Middleware hooks Relationships Populate refs Virtual fields Runtime Node.js Deno alpha support

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Add schema validation and type enforcement to MongoDB calls in a Node.js backend to catch bad data early

USE CASE 2

Define data models with automatic field validation, defaults, and indexes instead of managing them manually

USE CASE 3

Use pre- and post-save middleware hooks to run logic like password hashing automatically before writes

USE CASE 4

Pull related documents together across collections using Mongoose's populate feature without writing raw joins

Tech stack

JavaScriptNode.jsMongoDBTypeScript

Getting it running

Difficulty · easy Time to first run · 5min

Requires a running MongoDB instance and a connection string to connect to.

In plain English

Mongoose is a MongoDB object modeling tool for JavaScript, designed to work in an asynchronous environment. MongoDB is a database that stores information as JSON-like documents instead of rows in tables, and Mongoose sits between your application code and that database to give you a friendlier, more structured way of working with it. The README states that Mongoose supports Node.js and has alpha support for Deno. The core idea is the schema. You describe the shape of a record, what fields it has and what types of data those fields hold, by writing a Schema in plain JavaScript, listing fields like author, title, body, and date with their types. From that schema you create a Model, which is what you actually call to make, find, update, and delete documents in the database. The Schema definition also handles validators (both synchronous and asynchronous), default values, getters and setters, indexes, middleware (functions that run before or after operations like saving), instance methods and statics, plugins, and what the README calls "pseudo-JOINs" for pulling related data together. Mongoose buffers commands until the connection to MongoDB is ready, so you can define models and start querying without waiting on the connection promise. Model names are passed in singular form and Mongoose automatically maps them to the plural collection name in the database. You would use Mongoose when you are writing a Node.js or Deno app that stores its data in MongoDB and you want enforced structure, validation, and reusable behaviour around your documents instead of working with the raw MongoDB driver. The README points to mongoosejs.com for full docs, a plugins search site, and notes Mongoose 9.0.0 was released on November 21, 2025 with documented breaking changes.

Copy-paste prompts

Prompt 1

Using Mongoose, write me a User schema for a Node.js app with email (unique, required), hashed password, createdAt timestamp, and a role field.

Prompt 2

Show me how to add a pre-save middleware in Mongoose that automatically hashes a password before storing it.

Prompt 3

I have two Mongoose models, User and Post. Show me how to populate the author field on a Post with the full User document.

Prompt 4

Write a Mongoose model for a blog post with title, body, tags array, and an isPublished boolean defaulting to false, plus a createdAt timestamp.

Prompt 5

How do I create a Mongoose plugin that adds updatedAt and createdAt fields to every model in my app?

Open on GitHub → Explain another repo

← automattic on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.