diff --git a/cloud/examples/connectjira.mdx b/cloud/examples/connectjira.mdx
index 95ecc366..04317f28 100644
--- a/cloud/examples/connectjira.mdx
+++ b/cloud/examples/connectjira.mdx
@@ -117,8 +117,24 @@ Before getting started with this part of the setup ensure that you have complete
   - Provide the **Jira Issue type** you want to have created. 
   - Add the Closed status. (Default is "Done" but this field can be edited)
   - Choose your preferred options (toggle) for **Severity** and **Deduplication**. 
-  - Add any Custom field details you want to include.
-     - Refer to [an example on custom fields from ProjectDiscovery](/opensource/nuclei/running#nuclei-reporting) (*scroll to Jira*)
+  - Add any Custom field details you want to include. Enter one entry per field, each mapping `id`, `name` or `freeform` to a value:
+
+    ```yaml
+    customfield_00001:
+      name: 'Nuclei'
+    customfield_00002:
+      freeform: '{{.CVSSMetrics}}'
+    priority:
+      id: '{{if eq .Severity "critical"}}10104{{else}}4{{end}}'
+    ```
+
+    <Note>
+      This box is the custom-fields block, so your entries go in directly. If you
+      paste an example that still has a `custom-fields:` (or `custom_fields:`)
+      line at the top, that line is ignored and the fields under it are used.
+    </Note>
+
+     - Use `id` or `name` for dropdown fields, and `freeform` for text fields.
      - Review Atlassian's documentation on [creating custom fields](https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/), or [locating existing custom field IDs](https://confluence.atlassian.com/jirakb/how-to-find-any-custom-field-s-ids-744522503.html).
   </Step>
   <Step title="Finalize your configuration for Jira">
diff --git a/opensource/nuclei/running.mdx b/opensource/nuclei/running.mdx
index fc2f846b..5310f7e9 100644
--- a/opensource/nuclei/running.mdx
+++ b/opensource/nuclei/running.mdx
@@ -1131,7 +1131,7 @@ jira:
   # freeform can be used if the custom field is just a text entry
   # Variables can be used to pull various pieces of data from the finding itself.
   # Supported variables: $CVSSMetrics, $CVEID, $CWEID, $Host, $Severity, $CVSSScore, $Name
-  custom_fields:
+  custom-fields:
     customfield_00001:
       name: 'Nuclei'
     customfield_00002: