diff --git a/docs/features/software-templates/writing-templates.md b/docs/features/software-templates/writing-templates.md
index f58db3ae91..81189f22a1 100644
--- a/docs/features/software-templates/writing-templates.md
+++ b/docs/features/software-templates/writing-templates.md
@@ -142,6 +142,12 @@ this:
       "type": "string",
       "title": "Last name"
     },
+    "nicknames":{
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "telephone": {
       "type": "string",
       "title": "Telephone",
@@ -161,6 +167,11 @@ this:
     "ui:emptyValue": "",
     "ui:autocomplete": "given-name"
   },
+  "nicknames": {
+    "ui:options":{
+      "orderable": false
+    }
+  }
   "telephone": {
     "ui:options": {
       "inputType": "tel"
@@ -202,6 +213,12 @@ spec:
           title: Last name
           ui:emptyValue: ''
           ui:autocomplete: given-name
+        nicknames:
+          type: array
+          items: 
+            type: string 
+          ui:options:
+            orderable: false
         telephone:
           type: string
           title: Telephone
@@ -304,7 +321,8 @@ You might have noticed in the examples that there are `{{ }}`, and these are a
 `yaml` together. All the form inputs from the `parameters` section, when passed
 to the steps will be available by using the template syntax
 `{{ parameters.something }}`. This is great for passing the values from the form
-into different steps and reusing these input variables.
+into different steps and reusing these input variables. To pass arrays or objects
+use the syntax `{{ json paramaters.something }}`.
 
 As you can see above in the `Outputs` section, `actions` and `steps` can also
 output things. So you can grab that output by using