Mongoose Schema vs Model: What's the Difference

Mongoose Schema vs Model: What's the Difference

Mongoose schemas and models are easy to confuse. They are different things that work together.

What Is a Schema

A schema defines the shape of a document: fields, types, defaults, validation, indexes. It is a blueprint. It does not talk to the database.

const userSchema = new mongoose.Schema({
  firstName: { type: String, required: true },
  email: { type: String, required: true, unique: true, lowercase: true },
  age: { type: Number, min: 18 },
  createdAt: { type: Date, default: Date.now }
});

What Is a Model

A model is a constructor compiled from a schema. It is what you use to query and save documents. It talks to the database.

const User = mongoose.model('User', userSchema);

const user = new User({ firstName: 'Kunal', email: '[email protected]' });
await user.save();

const found = await User.findOne({ email: '[email protected]' });

How They Relate

The schema defines the shape. The model takes the schema, compiles it, and gives you methods to create, read, update, and delete documents.

Schema Features

• Field types (String, Number, Date, ObjectId, etc.).
• Validation (required, min, max, enum, match).
• Defaults.
• Indexes (unique, sparse).
• Virtuals (computed properties).
• Middleware (pre and post hooks).
• Instance methods and static methods.

Model Methods

• Model.create(doc) - create one.
• Model.find(query) - find many.
• Model.findOne(query) - find one.
• Model.findById(id) - find by id.
• Model.findByIdAndUpdate(id, update) - update.
• Model.findByIdAndDelete(id) - delete.
• Model.countDocuments(query) - count.
• Model.updateMany(query, update) - bulk update.

Instance Methods

A document instance has methods like .save() and .remove(). You can add your own:

userSchema.methods.fullName = function() {
  return `${this.firstName} ${this.lastName}`;
};

const user = new User({ firstName: 'K', lastName: 'X' });
user.fullName(); // 'K X'

The Takeaway

A Mongoose schema defines the shape (fields, types, validation). A model is compiled from a schema and is what you use to query the database. Schema is the blueprint; model is the constructor. Both are needed, but they do different things.