Population for references in Express

Introduction

Population lets you automatically fill in related data from other collections. It saves time by linking references for you.

When you want to show detailed info from related documents in a database.

When you have IDs stored but need full objects to display or use.

When building APIs that return connected data in one response.

When you want to avoid multiple database queries for related data.

Syntax

Express

Model.find().populate('fieldName').exec(callback)

Use the exact field name that holds the reference ID in your schema.

You can chain populate() to fill multiple references.

Examples

This fills each user's posts field with full post documents instead of just IDs.

Express

User.find().populate('posts').exec((err, users) => { /* use users with posts filled */ })

This replaces the customer ID in the order with the full customer document.

Express

Order.findById(orderId).populate('customer').exec((err, order) => { /* order.customer is full customer info */ })

This fills both author and publisher references in each book.

Express

Book.find().populate('author').populate('publisher').exec(callback)

Sample Program

This Express app connects to a MongoDB database with authors and books. When you visit /books, it returns all books with full author info filled in automatically using populate.

Express

import express from 'express';
import mongoose from 'mongoose';

const app = express();

// Define schemas
const authorSchema = new mongoose.Schema({ name: String });
const bookSchema = new mongoose.Schema({ title: String, author: { type: mongoose.Schema.Types.ObjectId, ref: 'Author' } });

// Create models
const Author = mongoose.model('Author', authorSchema);
const Book = mongoose.model('Book', bookSchema);

// Connect to MongoDB
mongoose.connect('mongodb://localhost:27017/library');

app.get('/books', async (req, res) => {
  try {
    // Find books and populate author details
    const books = await Book.find().populate('author').exec();
    res.json(books);
  } catch (err) {
    res.status(500).send(err.message);
  }
});

app.listen(3000, () => console.log('Server running on http://localhost:3000'));

Important Notes

Population works only if your schema defines the reference with ref.

You can specify which fields to include or exclude inside populate for better performance.

Population can slow queries if you fill many or large references, so use it wisely.

Summary

Population fills referenced fields with full documents automatically.

It helps return connected data in one query instead of many.

Use it by calling populate('fieldName') on your query.