What are dynamic modules in NestJS and when do you use them?

Difficulty: 5/10

module configuration, conditional providers, library reuse

A dynamic module returns a DynamicModule object from a static method (conventionally forRoot(), forFeature(), or register()) so the caller can pass configuration at import time. Use it for library modules like config, TypeORM, or mailer where behavior must vary per consumer.

Dynamic modules allow you to create customizable modules whose providers are determined at import time, based on options passed by the consuming module.

Dynamic module example

Common naming conventions:

1
forRoot() — used once at the app level with global configuration.
2
forFeature() — used in feature modules with feature-specific config (e.g., TypeORM entities).
3
register() — general-purpose configuration, used in any module.

Scenario Questions

0-2 years experience

2-5 years experience

1You have a feature flag that should enable a payment provider only in production. Walk me through how you’d use a dynamic module to conditionally register that provider.

Follow-up Questions