diff --git a/docs/chapters/subcommands/convert.rst b/docs/chapters/subcommands/convert.rst
index 8a4d6638..c20c4bae 100644
--- a/docs/chapters/subcommands/convert.rst
+++ b/docs/chapters/subcommands/convert.rst
@@ -1,15 +1,27 @@
 convert
 =======
 
-Convert a thin jail to a thick jail.
+Convert allows converting a thin jail to a thick jail.
+It also allows converting a thick jail to a customized release.
+
+Converting a thin jail to a thick jail requires only the target jail.
 
 .. code-block:: shell
 
   ishmael ~ # bastille convert azkaban
-  [azkaban]:
-  ...
 
-Syntax requires only the target jail to convert.
+Converting a thick jail to a custom release requires a target jail as 
+well as custom release name.
+
+.. code-block:: shell
+
+  ishmael ~ # bastille convert azkaban myrelease
+
+This release can then be used to create a thick jail using the ``--no-validate`` flag.
+
+.. code-block:: shell
+
+  ishmael ~ # bastille create --no-validate customjail myrelease 10.0.0.1
 
 .. code-block:: shell