Creating work items in Quick Planner boards

You can quickly create work items using Quick Planner. When you create a work item, you can set many of its attributes by using the attribute icons under the Create a work item field

Before you begin

Open Quick Planner by selecting Plans > Quick Planner

About this task

You must have already created a work board or a plan board.


  1. Click in the Create a work item field and type a summary.

    Shows the Create a work item field and a window under the field that displays attribute icons

    When you click in the field, a window opens under it that displays attribute icons.
  2. Click the attribute icons to set attribute values for the work item.
    Tip: Required attributes are designated by a red asterisk (red asterisk icon).
    1. Type (Type icon) icon
    2. Description (Description icon) icon
    3. File Against (File Against icon) icon
    4. Owned By (Owned By icon) icon
    5. Priority (Priority icon) icon
    6. Severity (Severity icon) icon (defects only)
    7. Tags (Tags icon) icon
    8. Found In (Found In icon) icon (defects only)
    9. Due Date (Due Date icon) icon
    10. Subscribed By (Subscribed By icon) icon
    11. Parent (Parent icon) icon
    When you set an attribute, the keyboard shortcut for the attribute is displayed after the summary. Notice how some of the icons change after you set the attribute values.

    Shows the Create a work item field with the attribute shortcuts and values

    Note: The Description and Due Date attributes do not have keyboard shortcuts. However, these values are set when you create the work item.
    Alternatively, instead of clicking the icons, you can type keyboard shortcuts and set values for most of these attributes in the Create a work item field. The following list shows the keyboard shortcuts for the attributes that have a corresponding icon.
    • Type: *Type
    • Filed Against: ^Category
    • Owned By: @:Owner
    • Priority: $Priority
    • Severity (defects only): !Severity
    • Tags: #Tag
    • Found In: >Release
    • Subscribed By: @Subscriber
    • Parent: ->Parent

    To display suggestions for all attributes and their values, press Ctrl+Space.

    If you have created custom attributes in the project area admin page, you can select them here as well. For example, for the work item type defect, the user has created a custom attribute Release:
    Custom defect attribute
    Make this attribute a precondition:
    Precondition a required attribute
    When creating a new defect, this attribute appears in the drop down:
    These attributes are supported in quick create:
    • Tag
    • Small String
    • Timestamp
    • Integer
    • Category
    • Deliverable
    • Impact
    • Complexity
    • Boolean
  3. Click CREATE.
  4. After you create the work item, you can edit the work item fields in Quick Planner. You can click the Summary field, and edit the work item summary:
    Edit wotk item summary
  5. You can also enhance the Description field by using the extended set of rich-text capabilities:
    Rich text description
  6. After you create the work item, you can add new or existing child work items from the Child Task Breakdown view. To display this view, click the Open child task breakdown Open child task breakdown icon) icon that is included in the list of quick access actions for the work item:
    Shows a work item summary that is displayed in a view. The Open child task breakdown icon is included in the list of quick access actions for the item.
    The child work item opens in a new window.

    The type of the child work item depends upon what has been configured in the project area configuration.

    • If you have configured the default child work item type in the project area editor, then when you open child task break down in Quick Planner, the child work item type is determined by what has been configured for the parent work item type.
    • If the default work item type has not been explicitly configured then it defaults to the Task work item type if it exists. If the project does not have a work item type with id Task then it selects the first work item defined in the project.

    For more information about configuring default work item types, see Creating child work items in the web client.

    You can also remove the child-parent dependency in a work item by dragging and dropping the child work item from inside the hierarchy to the root level of the lane, thereby breaking the parent-child relationship.

  7. You can move a work item from one lane to another by dragging and dropping the work item. This changes the state of the work item to the state of the new lane. If the state changes to Resolved or Closed, a dialogue appears asking you to choose the resolution.
    Choose resolution

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki