Add Plane Custom Properties to a Work Item Type
Add Plane custom properties beneath a work item type, then choose whether each property is active or mandatory. New items of that type show those fields.
Project Admins configure type properties on an eligible Pro plan. Rich text and release-picker fields are Business features; governed Enterprise Grid types use workspace administration. Verify the installed self-hosted edition before rollout.
Example: add an Environment dropdown to Bug with Production and Staging, then make it mandatory only after the team agrees how unknown environments should be recorded.
Step-by-step guide
Choose the intended work item type
Open Project settings > Work item Types and select Bug. Put the field on the type that needs it rather than collecting the same value on every Task.
Define the property
Select Add New Property and enter a title, description and property type. Choose a dropdown for controlled Environment values instead of free text that produces inconsistent spellings.
Configure availability and validation
Add the allowed choices, keep Active enabled, and set Mandatory only if the creator can reliably provide the value. Create the property to save it.
Exercise the creation form
Create a Bug and check that Environment appears and its required validation behaves as expected. Save a filled example and inspect its value on the work item.
Common mistakes
Deleting a field during cleanup
Deactivate a property before considering deletion so historical values are not casually lost. Review existing usage before structural changes.
Sources and verification
Based on product documentation checked on 2026-11-04. This is a documentation-based guide, not a hands-on benchmark. Features and availability can change.