Feature flags
Feature flags are used to introduce experimental or other opt-in features. They must be specified in the pipeline script.
nextflow.enable.configProcessNamesValidation
Deprecated since version 25.10.0: Use the strict syntax instead. It validates process selectors without producing false warnings.
When
true
, prints a warning for everywithName:
process selector that doesn’t match a process in the pipeline (default:true
).nextflow.enable.dsl
Deprecated since version 25.04.0.
Defines the DSL version to use (
1
or2
).nextflow.enable.moduleBinaries
When
true
, enables the use of modules with binary scripts. See Module binaries for more information.nextflow.enable.strict
When
true
, the pipeline is executed in “strict” mode, which introduces the following rules:When reading a params file, Nextflow will fail if a dynamic param value references an undefined variable
When merging params from a config file with params from the command line, Nextflow will fail if a param is specified from both sources but with different types
When using the
join
operator, thefailOnDuplicate
option istrue
regardless of any user settingWhen using the
join
operator, thefailOnMismatch
option istrue
(unlessremainder
is alsotrue
) regardless of any user settingWhen using the
publishDir
process directive, thefailOnError
option istrue
regardless of any user settingIn a process definition, Nextflow will fail if an input or output tuple has only one element
In a process definition, Nextflow will fail if an output emit name is not a valid identifier (i.e. it should match the pattern
/[A-Za-z_][A-Za-z0-9_]*/
)During a process execution, Nextflow will fail if a received input tuple does not have the same number of elements as was declared
During a process execution, Nextflow will fail if the
storeDir
directive is used with non-file outputsNextflow will fail if a pipeline param is referenced before it is defined
Nextflow will fail if multiple functions and/or processes with the same name are defined in a module script
nextflow.preview.output
New in version 24.04.0.
Experimental: may change in a future release.
When
true
, enables the use of the workflow output definition.nextflow.preview.recursion
Experimental: may change in a future release.
When
true
, enables process and workflow recursion.nextflow.preview.topic
New in version 24.04.0.
Deprecated since version 25.04.0: This feature flag is no longer required to use topic channels.
When
true
, enables topic channels feature.