diff --git a/docs/cli.rst b/docs/cli.rst
index 5093bacdd0..3124e7fb49 100644
--- a/docs/cli.rst
+++ b/docs/cli.rst
@@ -1265,6 +1265,12 @@ facilitates rapid iterations, inspections of any pipeline as well as debugging.
     $ nextflow run nextflow-io/hello -with-tower
  
 
+- Invoke the nextflow pipeline execution with a custom parameters ``YAML/JSON`` file. 
+The parameters which are specified through this mechanism are merged with the resolved configuration (base configuration and profiles) and only the common fields are overwritten by the ``YAML/JSON`` file.::
+
+    $ nextflow run main.nf -params-file pipeline_params.yml
+ 
+
 --------------------
 self-update   
 --------------------
@@ -1284,7 +1290,7 @@ Update the nextflow runtime to the latest available version.
 
 **Description**
 
-The ``self-update`` command directs the ``nextflow`` cli to update itself to the latest stable release.
+The ``self-update`` command directs the ``nextflow`` cli to update itself to the latest stable release. 
 
 
 **Examples**