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
Select Settings > Work items
Under FIELDS, select Custom fields
Select Create custom field
Make sure to select All to view the available field options
Select the field type Paragraph (Supports rich text) and select Next
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
When you have entered the field details, select Create
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.
Select Settings > Work items
Under FIELDS, select Field Configurations to view all your field configurations
Locate the field configuration of the field you created and select Renderers
Choose the Wiki Style Renderer and select Update
Set the default value for the custom field
Select Settings > Work items
Under FIELDS, click Custom fields
Find the custom field you created, select ... > Contexts and default value
In the configuration scheme section, select Edit Default Value
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|
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 |
Was this helpful?