---
title: Project-level custom fields
description: Project-level custom fields in Toggl 2.0
---

[Skip to content](https://docs.toggl.com/project-level-custom-fields#main-content)

English

Show submenu for translations

[![logo-dark](https://docs.toggl.com/hs-fs/hubfs/logo-dark.png?width=223&height=85&name=logo-dark.png)](https://docs.toggl.com/?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Go to Toggl](https://focus.toggl.com/)

[Go to Toggl](https://focus.toggl.com/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Toggl 2.0 Knowledge Base](https://docs.toggl.com/?hsLang=en)
2. [Admin Settings & Security](https://docs.toggl.com/admin-settings-security?hsLang=en)
3. [Workspace Setup](https://docs.toggl.com/admin-settings-security?hsLang=en#workspace-setup)

# Project-level custom fields

### What are project-level custom fields?

Project-level custom fields let admins attach structured business metadata to projects in Toggl 2.0: things like billing codes, cost centers, department, region, project type, or a Salesforce Account ID. Once a field is defined, every project in the workspace can carry a value for it, and that value can be used to filter and group projects across reports, dashboards, and project lists.

Use custom fields when you need consistent, queryable categorization on projects, instead of encoding information in project names or maintaining a parallel spreadsheet.

⚡Project-level custom fields are available on the **Premium** and **Enterprise** plans.

---

### Who can use custom fields?

- **Admins** create and manage the custom field definitions for the workspace, including the list of options inside Select and Multi-select fields.
- **Project managers** (and anyone else with edit access to a project) can fill in and update custom field values on the projects they manage.
- **Anyone who can view a project** can see the field values on the Project page and use them to filter or group.

---

### Field types

When creating a field, admins choose one of the following types:

| Type | What it stores | Example |
| --- | --- | --- |
| Select | One value from a predefined list | P&L category: CTI, CTM, OpEx, G&A |
| Multi-select | One or more values from a predefined list | Compliance labels |
| Text | Free-form text | Billing code, external reference ID |
| Number | Whole numbers | PO number, cost factor |
| Date | A single date | Review deadline |
| Checkbox | A true / false toggle | Client-approved |
| Members | A reference to a workspace member | Reviewer, engagement lead |

**Members field options**

When a field’s type is *Members*, two extra options appear when you create or edit it:

- *Allow only one member*: only one member can be picked in this field. If any Project already has more than one member in the field, you have to remove the extra members before you can switch this on.
- *Allow only specific members*: only the members you choose can be picked. You can select people one by one, or select a team to add all of its current members at once. You need to choose at least one member. Example: an “Executive owner” field that only lists your leadership team and holds exactly one person

---

### Setting up custom fields (admins)

1. Open **Settings** in Toggl 2.0.
2. Go to **Custom fields** in the left sidebar.
3. Click **New project field**
4. Give the field a name, choose a type, and (for Select / Multi-select) add the list of options.
5. Save. The field is immediately available on every project in the workspace.

<iframe data-hsv-src="https://play.hubspotvideo.com/v/21421994/id/214590993777" referrerpolicy="origin" sandbox="allow-forms allow-scripts allow-same-origin allow-popups" allow="autoplay; fullscreen;" style="position: absolute !important; width: 100% !important; height: 100% !important; left: 0; top: 0; border: 0 none; pointer-events: initial" title="HubSpot Video" loading="lazy" data-hsv-id="214590993777" data-hsv-style="" data-hsv-width="1152" data-hsv-height="720" data-hsv-autoplay="false" data-hsv-loop="false" data-hsv-muted="false" data-hsv-hidden-controls="false" data-hsv-full-width="false"></iframe>

 

- **Search:** Use the **Search fields or values** bar at the top of Custom fields settings to find a field or option quickly, which helps in larger workspaces
- **Editing or deleting a field:** open the field from the list to rename it, add or rename options, or delete it. Deleting a field removes its values from every project; this cannot be undone!
- **Field limit.** A workspace can define up to **50 project-level custom fields**. This limit is deliberate: beyond ~50, project creation becomes noisy and reporting harder to navigate.

---

### Filling in values on a project

1. Open the project from the **Projects** list.
2. Custom fields appear on the **Project page**, alongside name, client, and tags.
3. Click into a field and choose or enter a value.
4. Changes save automatically.

Fields without a value are simply blank; nothing is required by default.

![adding value for a custom field in a project](https://docs.toggl.com/hs-fs/hubfs/Knowledge%20Base%20Import/adding%20value%20for%20a%20custom%20field%20in%20a%20project-1.png?width=670&height=355&name=adding%20value%20for%20a%20custom%20field%20in%20a%20project-1.png)

 Filtering and grouping by custom fields

Project-level custom field values are available everywhere a project is shown:

- **Project list:** filter or group by any custom field to focus on a subset of projects (e.g. all projects where Vertical = Enterprise).
- **Reports:** add custom fields as filters and as grouping dimensions to slice utilization, time, or revenue by business metadata.
- **Dashboards:** the same filter and group-by set is available on dashboards, so portfolio-level views can be built around your taxonomy.

<iframe data-hsv-src="https://play.hubspotvideo.com/v/21421994/id/214591013440" referrerpolicy="origin" sandbox="allow-forms allow-scripts allow-same-origin allow-popups" allow="autoplay; fullscreen;" style="position: absolute !important; width: 100% !important; height: 100% !important; left: 0; top: 0; border: 0 none; pointer-events: initial" title="HubSpot Video" loading="lazy" data-hsv-id="214591013440" data-hsv-style="" data-hsv-width="1152" data-hsv-height="720" data-hsv-autoplay="false" data-hsv-loop="false" data-hsv-muted="false" data-hsv-hidden-controls="false" data-hsv-full-width="false"></iframe>

---

### Tips for designing a good field set

- **Pick fields you will actually report on.** If you would not group or filter by it, it probably does not belong as a field.
- **Prefer Select over Text** when there is a finite list of values. Selects keep the data clean and make filtering reliable.
- **One field, one purpose.** Splitting "Department - Region" into two fields is almost always better than encoding both in one Text value.
- **Coordinate option lists.** If two fields share the same list of values (e.g. Region), consider whether one field is enough.

---

### FAQ

**Can different teams have different field sets?**

Not in the first release. Custom fields are defined at the workspace level and apply to every project. Per-team or per-client field sets are being considered for a later release.

**Is there a limit on the number of fields?**

Yes. A workspace can define up to **40** project-level custom fields. The limit is intentional and balances flexibility against keeping project creation and reporting manageable.

**What happens to my data if I delete a field?**

All values for that field are removed from every project. There is no recovery, so prefer renaming or repurposing a field over deleting it.

**Can I bulk-edit custom field values across many projects?**

Bulk editing of projects already supports the standard project attributes; see [Bulk Editing Projects and Tasks in Toggl](https://support.toggl.com/focus/bulk-editing-projects-and-tasks-in-toggl?hsLang=en). Bulk-editing custom field values is on the roadmap for the next iteration.

**Will my labels be replaced by custom fields?**

No. Labels remain available and are best used for ad-hoc, user-applied tagging. Custom fields are for admin-defined, structured metadata that you want to report on. The two can be used together.

- [Getting started](https://docs.toggl.com/getting-started?hsLang=en#main-content)

    - [Start here](https://docs.toggl.com/getting-started?hsLang=en#start-here)
    - [Quickstart Guides](https://docs.toggl.com/getting-started?hsLang=en#quickstart-guides)
    - [Set up your Workspace](https://docs.toggl.com/getting-started?hsLang=en#set-up-your-workspace)
    - [Toggl Guides for Toggl Track and Toggl Plan users](https://docs.toggl.com/getting-started?hsLang=en#toggl-guides-for-toggl-track-and-toggl-plan-users)
- [Using Toggl, page by page](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#main-content)

    - [Timer](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#timer)
    - [Reports](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#reports)
    - [Projects](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#projects)
    - [Tasks](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#tasks)
    - [Timeline](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#timeline)
    - [Members](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#members)
    - [Approvals](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#approvals)
    - [Time Off](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#time-off)
    - [Profile Settings](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#profile-settings)
- [Admin Settings & Security](https://docs.toggl.com/admin-settings-security?hsLang=en#main-content)

    - [Workspace Setup](https://docs.toggl.com/admin-settings-security?hsLang=en#workspace-setup)
    - [Tracking & Rates](https://docs.toggl.com/admin-settings-security?hsLang=en#tracking-rates)
    - [Single Sign-on](https://docs.toggl.com/admin-settings-security?hsLang=en#single-sign-on)
- [Subscription & Billing](https://docs.toggl.com/subscription-billing?hsLang=en)
- [Toggl Apps](https://docs.toggl.com/toggl-apps?hsLang=en#main-content)

    - [Mobile](https://docs.toggl.com/toggl-apps?hsLang=en#mobile)
    - [Desktop](https://docs.toggl.com/toggl-apps?hsLang=en#desktop)
    - [Browser Extension](https://docs.toggl.com/toggl-apps?hsLang=en#browser-extension)
- [API & Integrations](https://docs.toggl.com/api-integrations?hsLang=en)
- [Troubleshooting & FAQs](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#main-content)

    - [My Toggl Acount](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#my-toggl-acount)
    - [Common Questions](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#common-questions)

<https://github.com/toggl/> <https://www.linkedin.com/company/toggl/> <https://community.toggl.com/>

Copyright © 2026. Toggl. [Privacy Policy](https://toggl.com/legal/focus/privacy/)

```json
{
  "@context" : "https://schema.org",
  "@type" : "VideoObject",
  "contentUrl" : "https://21421994.fs1.hubspotusercontent-na1.net/hubfs/21421994/video_assets/214590926879/inherited/web_optimized.mp4",
  "dateModified" : "2026-06-08T12:33:00.922Z",
  "duration" : "PT37S",
  "height" : 720,
  "name" : "custom fields",
  "thumbnailUrl" : "https://21421994.fs1.hubspotusercontent-na1.net/hubfs/21421994/custom%20fields.mp4/medium.jpg",
  "uploadDate" : "2026-06-08T12:32:48.873Z",
  "width" : 1152
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "VideoObject",
  "contentUrl" : "https://21421994.fs1.hubspotusercontent-na1.net/hubfs/21421994/video_assets/214590942630/inherited/web_optimized.mp4",
  "dateModified" : "2026-06-08T12:38:23.861Z",
  "duration" : "PT12S",
  "height" : 720,
  "name" : "filter by custom field in reports",
  "thumbnailUrl" : "https://21421994.fs1.hubspotusercontent-na1.net/hubfs/21421994/filter%20by%20custom%20field%20in%20reports.mp4/medium.jpg",
  "uploadDate" : "2026-06-08T12:38:13.123Z",
  "width" : 1152
}
```