Skip to main content

Manage Custom Fields in Projects

Manage which organization-wide custom fields are used in your project. Add project-specific custom fields, set field values for different item types, and configure field visibility and requirements.

Audience

This guide is designed for project manager.

Steps​

Step 1: Navigate to Project Custom Fields​

From Project Settings, click Custom Fields in the left menu. This shows all available custom fields and which are enabled for this project. You can also create project-specific custom fields not available to other projects.

Navigate to Project Custom Fields

tip

Project-specific fields are only available in this project; shared fields apply to all projects.

Step 2: Review available fields​

The page shows two types of fields: Organization Fields (defined at org level, shared across projects) and Project-Specific Fields (only for this project). Check which fields are enabled. Disabled fields don't appear in this project.

Review available fields

tip

Organization fields can't be modified per-project; project-specific fields can.

Step 3: Enable organization fields​

For organization-defined fields you want to use, click Enable. Once enabled, the field appears in forms and can be filled in. You can enable/disable fields anytime without losing data.

Enable organization fields

tip

Enabling fields after project start is fine - existing items won't break.

Step 4: Configure field requirements​

For enabled fields, you can set project-specific configuration: Required (must fill), Visible (show in UI), Default value (pre-fill form). These override organization settings for this project only.

Configure field requirements

tip

Making a field required in the project doesn't affect other projects.

Step 5: Create project-specific fields​

Click Create Project Field to add a field only for this project. Examples: "Site Location Code" for a specific project, "Client Approval Date", or "Weather Conditions" (only relevant for this project).

Create project-specific fields

tip

Project fields use the same types as organization fields (text, number, date, dropdown, etc.).

Step 6: Assign fields to item types​

Configure which fields appear for which item types: Tasks get certain fields, Documents get others, People get different ones. This customization helps collect relevant data for each item type.

Assign fields to item types

tip

Same field can apply to multiple item types if relevant to all.

Step 7: Set field grouping and view usage​

Organize custom fields into groups in the UI (Project Financials, Quality Assurance, Team Information, etc.) to improve user experience. Groups appear as collapsible sections in forms. You can also see how many items have values for each field, helping you identify which fields are actually being used.

Set field grouping and view usage

tip

Logical grouping and usage tracking help maintain effective field definitions.

Step 8: Configure field defaults​

Set default values for fields in this project: Default status "Planning", default priority "Medium", default location "Site A". Defaults save time when creating items and ensure consistency.

Configure field defaults

tip

Defaults can always be changed on individual items.

Step 9: Use fields in reports and manage visibility​

Custom fields appear in reports as merge fields - use {{ item.custom_field_name }} to include values in document templates. Control field visibility: All team members, Project Admins only, or specific roles only. Sensitive fields like budget authority or approval status can have restricted visibility to protect project data.

Use fields in reports and manage visibility

tip

All enabled fields are available for reports. Visibility controls prevent unauthorized access.

Step 10: Remove unused fields​

To clean up the UI, disable fields not being used in this project. Click Disable next to a field. The field and its data remain in the system; you can re-enable anytime. Disabled fields don't appear in forms or reports.

Remove unused fields

tip

Disabling doesn't delete data - existing values are preserved.

Video Tutorial​


Last updated: 2025-12-08