Set custom field default value to rich text instead of plain text in Jira

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Generally, the default values for custom fields are plain text (no markup or formatting). If you're looking to set the default value for a custom field to a rich text value, which can include tables, lists, or other formatting, you can follow these steps to do so.

Create a new custom field

  1. Select Settings > Work items

  2. Under FIELDS, select Custom fields

  3. Select Create custom field

    • Make sure to select All to view the available field options

  4. Select the field type Paragraph (Supports rich text) and select Next

  5. Add the details for your field

    • The name you select appears as the custom field's title wherever the field appears

    • The description appears below the field when creating and editing issues, but not when browsing issues

  6. When you have entered the field details, select Create

  7. Add the new custom field to one or multiple desired screens by ticking the corresponding box and select Update

To configure the layout of the new Jira work item view—which fields appear and the order they appear in—open a work item and choose Configure at the bottom-right. To find out more about configuring the work item layout, check out Configure field layout in the work item view.

Set the field's renderer to Wiki Style

Before you change the renderer for a specific field, please read Configuring renderers, paying particular attention to the Implications for Jira operations section.

  1. Select Settings > Work items

  2. Under FIELDS, select Field Configurations to view all your field configurations

  3. Locate the field configuration of the field you created and select Renderers

  4. Choose the Wiki Style Renderer and select Update

Set the default value for the custom field

  1. Select Settings > Work items

  2. Under FIELDS, click Custom fields

  3. Find the custom field you created, select ... > Contexts and default value

  4. In the configuration scheme section, select Edit Default Value

  5. Enter a default value using Text Formatting Notation

    • For example, to create tables you can use:

      ||heading 1||heading 2||heading 3|| |col A1|col A2|col A3| |col B1|col B2|col B3|
  6. Select Set Default

Once you create the new issue the default value of the field you created will be shown in rich text format. Here's an example of what the table might look like based on our default value:

heading 1

heading 2

heading 3

col A1

col A2

col A3

col B1

col B2

col B3

Updated on June 25, 2025

Still need help?

The Atlassian Community is here for you.