Every Item in Craft.io includes the following predefined set of fields. These properties help you categorize and prioritize your work, and can be set inside the properties panel of any item:
Status: Select the current status of the item (You can define your workflow inside the Workspace Settings).
Assignee: Assign a team member or a team to work on each item.
Release: Assign a release for the item, which will determine the time cadence in which this item will be ready.
Sprint: Assign the sprint in which this item will be worked on.
Time Estimate: Define the amount of time you estimate it will take to work on this item.
Dates: Define the dates during which the item will be worked on.
Dev Status: The status of the corresponding issue in a dev tool that has been synced to the workspace (Jira etc.).
Importance: Select how important the item is to your product. Does it have Low, Medium, or High importance, or is it a Blocker?
Effort: You can set the level (scale of 1-10) of the Effort required to deliver the item.
Value: You can set the level (scale of 1-10) of the Value the item has to your business.
Objective: Assign the relevant objective from the list of objectives you've defined in the Strategic Inputs.
Key result: Assign the relevant Key result from the list of Key results you've defined in the Strategic Inputs.
Persona: You can set a link to a persona you've defined in the Strategic Inputs.
Kano: Using the Kano model for customer satisfaction, you can set whether this is a Basic, Performer, or Exciter solution.
Labels: You can add labels to an item so that the item can be easily found when running a search.
Creating Custom Fields
In addition to the above fields, you can set up your own set of fields. You can add new custom fields directly from the Table View:
You can also create and manage custom fields from the 'Workspace Settings' -> 'Custom fields' page (to get there, click on the 'Settings' button in the bottom left toolbar and select 'Workspace Settings' from the menu):
The following field types are available:
Number: A numeric field - for example: Business Value. You can select whether your field will appear as a “slider” or a “+/-” control.
Date: A Date field - for example: Due Date.
Single-Selection: A field that includes a predefined list - for example: Customer, Region. This type of field will allow selecting only a single value per item.
Multi Selection: A field that includes a predefined list but will allow selecting multiple values per item.
Team Member: A field that enables assigning a team member to a specific item.
Formula: A calculated field, shows the score of selected numeric or selection fields according to their specific weight. To learn more about formula fields, visit this article.
Text (single line): A free text field - for example: Comments.
Text (multi-line): A free text field that allows you to add additional description fields to an item - for example: Acceptance Criteria, Executive Summary, Release Notes. This type of field supports rich text formatting and can be mapped and synced to Jira and Azure DevOps correlating multi-line fields.
Once a field type is selected, you can set up the Field name, and choose specific item types for which this new field is relevant (the default is 'All Items'):
Tip: You can control the order of fields at the item properties panel as well as the order of items listed in your selection fields by dragging and dropping values into position.
Viewing and Using Custom Fields in Your Product
Your custom fields will appear across your product in the following places:
Item Properties Panel - Only for the selected Item types.
Table View - You can have your custom fields appear as a column by choosing them from the “+Column” drop-down.