# Create a Markdown-enabled Custom Field

Since it is impossible for a Jira Cloud's app to create its own custom field type, Markin provides Markdown Editor for fields of Jira Cloud’s built-in types. This gives you important benefits:

* All Markdown data is stored securely in your Jira Cloud the same way other Jira data is stored. **Your data will never be stored on our site.**
* Search, JQL, export, API, email notifications, and other field-related utilities will work the same way other fields work.

Please follow the instructions below to create a Markdown-enabled custom field.

## Create a new custom field

### Company-managed projects (classic projects)

#### New Jira Cloud UI

Create a new custom field of type **Paragraph (supports rich text)**. Configure the custom field (name, description, screens) normally. The renderer must be **Default Text Renderer.**

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FUtVMUfLr3B6kQx5tEpnl%2Fimage.png?alt=media\&token=c7701e99-e277-49c4-b1a2-99c21fd55cf9)

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2Fd0dTe415f2E0OePEGtt8%2Fimage.png?alt=media\&token=ec949433-e64a-4b1a-afeb-d1d0fd19f2e7)

#### Old Jira Cloud UI

Create a new custom field of type **Text Field (multi-line)**. Configure the custom field (name, description, screens) normally**.**

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ma7ua4NoSptEMaVrDMS%2Fsync%2F3696b1a2cc482b1dbd28dfd86f20672778feb06f.png?generation=1621504370951480\&alt=media)

### Team-managed projects (nextgen projects)

Create a custom field of type **Paragraph**.

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FZkSUJnHLAzrl9vYdiGmI%2Fimage.png?alt=media\&token=91ba4f57-deb9-4d76-a3a5-8fed614abbb5)

## Configure the newly created custom field as a Markdown field

Go to the **Project Settings** page of the corresponding project. Select **Markdown Fields** under the **Apps** menu. In the configuration page, select the field created in Step 1 along with all issue types in which you want it to appear as Markdown content.

Optionally you can turn on/off highlighting Gherkin keywords.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FWxvtEu2SXt5pLoxC0hN3%2Fimage.png?alt=media&#x26;token=0a1c4d3a-8533-422c-84ac-36bca8383db7" alt=""><figcaption><p>Markdown for Jira</p></figcaption></figure>

## Create an issue for testing

Create an issue for testing. Click on the **More Options (three-dots)** button. You should see the **Markdown Fields** section. The fields configured in the above steps should be displayed in the section.

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ma7ua4NoSptEMaVrDMS%2Fsync%2Fd48f42f895c1635a15da2624f38d4a1f27900d49.png?generation=1621504371170123\&alt=media)

Click on the fields inside the **Markdown Fields** panel to edit the content.

{% hint style="warning" %}
DO NOT edit the fields using Jira's built-in editors outside the **Markdown FIelds** panel.
{% endhint %}

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2F1PmBe1POzdjUlGUXtJxA%2Fimage.png?alt=media&#x26;token=41990b74-b52b-4223-9874-d006a8215708" alt=""><figcaption><p>Markdown for Jira</p></figcaption></figure>

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FtCKebIFbr1yiGxCXUeMr%2Fimage.png?alt=media&#x26;token=a07ef2f5-892d-4db5-9b99-66e541c41231" alt=""><figcaption><p>Markdown for Jira</p></figcaption></figure>

## Hide the original field editor

**If your project is company-managed (formerly classic),** you can also hide the original field editor. Please see the instructions here <https://support.atlassian.com/jira-software-cloud/docs/configure-field-layout-in-the-issue-view/#Configurefieldlayoutintheissueview-Hiddenfields>.

![Markdown for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ma7ua4NoSptEMaVrDMS%2Fsync%2F1bd0f7b5e18bf548e0b7ad49d788b3ab7cd5d61d.png?generation=1621504370947904\&alt=media)

## Fulstech AI Copilot for Writing (Preview)

AI Copilot leverages OpenAI's ChatGPT to help you revise the content effectively.

{% hint style="info" %}
This feature is powered by OpenAI's ChatGPT. The data you submit and the responses you receive are not used to fine-tune or improve OpenAI’s models or services. Each data request is sent to OpenAI individually, over an SSL-encrypted service, to process and send back to your Jira. OpenAI does not store the data you submit or the responses you receive.
{% endhint %}

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FBdEZHdYAPy4DYhyB748r%2Fimage.png?alt=media&#x26;token=7d623377-0e3a-4e9a-b883-75d87f845f68" alt=""><figcaption><p>Markdown for Jira</p></figcaption></figure>

To disable the feature, please click on the **Configure** button on the Jira Plugin Manager page.

<figure><img src="https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FROUfndlVPLDJeWpXDM9R%2Fimage.png?alt=media&#x26;token=b31c9dd9-8219-4e10-970a-1322cef241ad" alt=""><figcaption><p>Markdown for Jira</p></figcaption></figure>