Nobody Picked Me

    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/joigoose package

    8.0.2 • Public • Published


    npm version Build Status Dependencies Status

    Joi and Mongoose sitting in a tree K-I-S-S-I-N-G...

    Joi validation for your Mongoose models without the hassle of maintaining two schemas.


    ⚠️ WARNING! Use the v7.x.x branch of Joigoose if you're still using the scoped version of Joi.

    npm install joigoose


    1. Import Mongoose and Joi

    We must pass Mongoose into Joigoose so it knows about ObjectIds and other Mongoose specific stuff:

    const Mongoose = require("mongoose");
    const Joigoose = require("joigoose")(Mongoose);

    With Joi options which apply to all validators:

    const Mongoose = require("mongoose");
    const Joigoose = require("joigoose")(Mongoose, { convert: false });

    With subdocument options to all subdocuments:

    const Mongoose = require("mongoose");
    const Joigoose = require("joigoose")(Mongoose, null, {
      _id: false,
      timestamps: false,

    2. Write your Joi schema (see here about how to specify ObjectIds!)

    Things to know!

    Mongoose specific options can be specified in the meta object (see below).

    Arrays with items of different types will end up with the Mongoose type Mixed. Ideally, Joi schemas shouldn't have to contain Mongoose specific types, such as Mongoose.Schema.Types.ObjectId because these Joi schemas may be required to work on frontend clients too.

    var joiUserSchema = Joi.object({
      name: Joi.object({
        first: Joi.string().required(),
        last: Joi.string().required(),
      email: Joi.string().email().required(),
      bestFriend: Joi.string().meta({
        _mongoose: { type: "ObjectId", ref: "User" },
      metaInfo: Joi.any(),
      addresses: Joi.array()
          line1: Joi.string().required(),
          line2: Joi.string(),
        .meta({ _mongoose: { _id: false, timestamps: true } }),

    3. Convert your Joi schema to a Mongoose-style schema

    var mongooseUserSchema = new Mongoose.Schema(
      Joigoose.convert(joiUserSchema, options)

    Conversion options

    Options can be passed to the convert method as an object. Valid options are described below.

    Key Type Default Description
    typeKey String "type" The name of the key used for specifying the type in the generated schema.
      typeKey: '$type',

    4. Create your model

    User = Mongoose.model("User", mongooseUserSchema);

    5. Enjoy!

    var aGoodUser = new User({
      name: {
        first: "Barry",
        last: "White",
      email: "",
      metaInfo: {
        hobbies: ["cycling", "dancing", "listening to Shpongle"],
    }); (err, result) {
      // -> Success!
    var aBadUser = new User({
      name: {
        first: "Barry",
        last: "White",
      email: "Im not an email address!",
    }); (err, result) {
      // -> Error!
      // {
      //     "message": "User validation failed",
      //     "name": "ValidationError",
      //     "errors": {
      //         "email": {
      //             "properties": {
      //                 "type": "user defined",
      //                 "message": "Validator failed for path `{PATH}` with value `{VALUE}`",
      //                 "path": "email",
      //                 "value": "Im not an email address!"
      //             },
      //             "message": "Validator failed for path `email` with value `Im not an email address!`",
      //             "name": "ValidatorError",
      //             "kind": "user defined",
      //             "path": "email",
      //             "value": "Im not an email address!"
      //         }
      //     }
      // }

    Known Limitations

    I didn't spend long writing this, but I've aimed for 100% code coverage. It can be so much better, so help me out! Submit your issues and pull requests on GitHub.

    • No peer based validation (and, nand, or, xor, with, without, ref, assert, alternatives, when etc)
    • No Joi.binary object type
    • No Joi.func object type
    • No object type


    npm i joigoose

    DownloadsWeekly Downloads






    Unpacked Size

    19.2 kB

    Total Files


    Last publish


    • yoitsro