Skip to content
Templating.app Documentation

Supported Fields & Custom Fields

Description Templates provide flexibility by supporting various Jira field types. These templates allow you to tailor the Issue Create screen to match your workflows and project requirements. Below is a comprehensive list of supported field types and custom fields.

Supported Standard Fields

Description Templates support the following standard Jira fields:

  • Summary
  • Description
  • Assignee
  • Reporter
  • Priority
  • Labels
  • Components
  • Fix Version(s)
  • Affected Version(s)
  • Due Date
  • Target Start Date
  • Target End Date
  • Issue Type

Supported Custom Field Types

In addition to standard fields, many custom field types are supported:

  • Text Fields: Includes single-line and multi-line text fields.
  • Select Fields:
    • Dropdown (single select)
    • Multi-select
    • Radio Buttons
    • Multi-checkboxes
  • Date Fields:
    • Date Picker
    • Date-Time Picker
  • User Picker:
    • Single User Picker
    • Multi-user Picker
    • People Field
  • Other Fields:
    • URL Field
    • Float (Decimal) Field
    • Number Fields

Available User Conditions

User conditions allow you to specify requirements based on users or roles. These conditions include:

  • User Group Conditions:
    • User is in any of selected groups
    • User is not in any of selected groups
  • Project Role Conditions:
    • User has any of selected project roles
    • User does not have any of selected project roles

Groups and roles can be selected via a picker, ensuring precise control over who can trigger specific templates.

Value Types for Field Conditions

For each supported field type, you can define conditions using various value types:

  • Value Comparisons:
    • valueIsAfter
    • valueIsBefore
    • valueIsOn
    • valueIsNotOn
  • Empty/Non-Empty Checks:
    • valueIsEmpty
    • valueIsNotEmpty
  • Numeric Comparisons:
    • valueIsGreaterThan
    • valueIsLessThan
  • Equality/Containment Checks:
    • valueEqualsAnyOf
    • valueNotEqualsAnyOf
    • valuesContainAnyOf
    • valuesContainNoneOf
    • valuesContainAllOf
  • String Matching:
    • valueStartsWithAnyOf
    • valueEndsWithAnyOf
    • valueContainsAnyOf
    • valueDoesNotContainAnyOf
  • Group Membership:
    • userIsInAnyOfGroups
    • userIsNotInAnyOfGroups

Notes on Field Availability

  1. Field Missing from List: If a field is not visible in the available options, it may not yet be supported by Atlassian’s APIs or added to Templating.app.
  2. Warning Sign for Fields: A warning icon next to a field in the dropdown indicates that the field is not configured on the Issue Create screen for the selected issue type. You’ll need to update your Jira project’s field configuration to add it.

Enhancing Workflows

By leveraging the supported fields, Description Templates can:

  • Prepopulate issue descriptions with structured information.
  • Ensure mandatory fields are completed.
  • Streamline field behavior, such as making fields read-only or hidden, based on project needs.