Skip to main content

Overview

Fields are the data attributes on an item. Every item carries a set of built-in system fields, and you can extend items with custom fields defined by your organization. Together, they capture everything you need to track about a piece of work. Processes control which fields appear on items of a given type, the order they appear in, and whether they are required or optional.

System fields

System fields are built into every item. They cover the core attributes needed for work management, planning, time tracking, and auditing.

Item fields

These fields capture the primary data about a work item.
FieldTypeDescription
NameTextThe item title or summary
DescriptionRich textDetailed description content
PriorityListWork priority level (Low, Medium, High)
SeverityListImpact level (Trivial, Minor, Major, Showstopper)
StatusListCurrent workflow status (Open, Unassigned, Accepted, Approved, Assigned, In Backlog, In Sprint, In Progress, On Hold, Ready, Pending, Closed, Blocked)
ResolutionListFinal outcome (Unresolved, Resolved, Rejected, Ignored, Duplicate)
ApprovedToggleSimple approval capture
PointsIntegerWork estimation — more points equals more effort
Restricted toPickerWhich user groups can see certain data
ContainerPickerThe container the item belongs to
AreaPickerSub-grouping within the container (supports multi-select)
Owned byPickerWho reported or owns the item
Start dateDateWhen work is due to start
Due dateDateWhen work is due to finish
Percent completePercentCompletion percentage (0–100%)
Work estimateTimeEstimated effort (days and hours)
Cost centerPickerCost center for the item
CRMPickerLinked customer record
SKUPickerLinked stock unit
Job rolePickerJob role associated with the item
ProcessPickerThe business process the item follows
ResourcePickerThe person currently working on the item

Board and cycle fields

These fields connect items to the planning system.
FieldTypeDescription
BoardPickerThe board the item is planned on
CyclePickerThe cycle the item is assigned to

Clock fields

These fields track SLA clock state for the item.
FieldTypeDescription
Clock startDateWhen the item was placed on the clock
Clock finishDateWhen the item should be completed by
Clock deltaIntegerDifference in hours between start and finish
Clock hoursIntegerExpected duration of the clock in hours
Clock statusListClock state (Green, Amber, Red)

Audit fields

These fields are set automatically by the system.
FieldTypeDescription
SequenceIntegerItem sequence number within its container
Create dateDateWhen the item was created
Created byPickerWho created the item
Change dateDateWhen the item was last modified
Changed byPickerWho last modified the item
Email GUIDTextUnique ID for items created via email (system-only)
Record sourceTextWhere the item originated (user, email, API)

Feature fields

These fields support specific Ekso features.
FieldTypeDescription
Link typeListRelationship type for linked items (Duplicate, Related)
Time typeListCategory of time entry (Internal, Development, QA, R&D, PMO, Sales, Marketing)

Configuring system list fields

System fields that use the List type (Priority, Severity, Status, Resolution, Clock status) ship with default values, but you can configure them to match your workflow. For each value you can set:
PropertyDescription
ActiveToggle a value on or off. Inactive values are hidden from new items but preserved on existing ones.
ValueThe display name shown to users
ImageAn icon or visual indicator for the value
MetadataOptional metadata string for integrations or reporting
Default valueWhich value is pre-selected when a new item is created
Retire obsolete list values by toggling them inactive rather than deleting and re-creating them. This preserves referential integrity on existing items. Inactive values that are no longer in use on any item are deleted automatically.

Default field values

System list fields ship with default values that cover common workflows. Admins can add, rename, or remove values to match their organization’s needs.

Priority

Default: Medium
ValueIcon
LowPriority 3
MediumPriority 2
HighPriority 1

Severity

Default: Minor
ValueIcon
TrivialSignal Fair
MinorSignal Good
MajorSignal Strong
ShowstopperSignal Best

Status

Default: Unassigned Statuses are grouped into workflow phases that determine how items behave in boards, cycles, and reports.
ValueWorkflow phase
OpenOpen
UnassignedOpen
AcceptedOpen
ApprovedOpen
In BacklogOpen
In SprintOpen
ReadyOpen
PendingOpen
AssignedWorking
In ProgressWorking
On HoldWorking
ClosedClosed
BlockedBlocked

Resolution

Default: Resolved
Value
Unresolved
Resolved
Rejected
Ignored
Duplicate
Default: Related
Value
Duplicate
Related

Billable time types

Value
Internal
Development
QA
R&D
PMO
Sales
Marketing
All list field values are fully editable. Add values that match your workflow, retire values you do not use, and set the default to the value your team selects most often.

Custom field types

Beyond system fields, you can create custom fields to capture data specific to your organization. Ekso supports nine custom field types:
TypeWhat it storesExample use
TextFree-form textCustomer reference, external ID
IntegerWhole numbersStory points, item count
DecimalNumbers with fractional precisionCost estimate, hourly rate
PercentPercentage valuesCompletion percentage, discount
DateCalendar datesTarget date, review date
TimeDuration valuesEstimated hours, time spent
ToggleOn/off booleanRequires approval, is external
ListSingle selection from predefined valuesEnvironment, category, region
PickerLookup reference to related dataRelated user, container, cost center

Custom field properties

When you create a custom field, you configure the following properties:
PropertyDescription
FieldThe unique field name. Reserved field names (used by system fields) are not allowed.
PromptMaps to a localization string in language files — this is the label users see.
TypeThe data collection method (one of the nine types above). Set at creation and cannot be changed.
NotesA description or help text for the field.
Content typeHow the input is rendered (e.g., plain text, rich text). Applies to text fields.
Maximum lengthCharacter limit for text input. Set to zero for no limit.
Default valueThe value pre-filled when a new item is created.
Custom list fields have the same value configuration as system list fields — you can add values, assign images, set a default, and retire obsolete entries.

How processes use fields

A process determines which fields appear on items of that type, their display order, and whether each field is required or optional. The same field can behave differently across processes — required in one, optional in another, or absent entirely. Some fields are always present on every process and cannot be removed: the audit fields (CreateDate, ChangeDate, CreateBy, ChangeBy, RecordSource, EmailGuid) plus Name and Status. All other fields can be added, removed, reordered, and marked as required through the process Field tab.
To change which fields appear on an item type, update the process configuration under Settings > Process > Field. Processes are the single place that controls field visibility and requirements.
Constraints can further control what values are allowed in fields based on conditions, adding data integrity rules on top of the process configuration.