All instances of CodecRegistry configured by the application, via MongoClientSettings or withCodecRegistry method on MongoDatabase or MongoCollection are actually wrapped by the driver in another CodecRegistry, so effectively the application-provided instances are used only as a CodecProvider. This should be documented clearly, as it's confusing to both users and to driver developers.