Required Fields for Tasks in Toggl Focus

This guide explains the Required Fields feature in Toggl Focus, a workspace-level setting that lets admins make certain task fields mandatory before a task can be saved. It covers how to enable required fields, which fields are currently supported (tags and project), and how validation applies across the task modal, subtasks, and browser extension. It also outlines behaviour for tasks created before the feature was enabled, API error handling, mobile limitations, and answers common questions about scope and configuration.

What are Required Fields?

Required Fields is a workspace-level setting that lets admins mark certain task fields as mandatory. When enabled, users must fill in all required fields before they can create or save a task. This applies across all surfaces: the task modal, inline task creator, browser extension, and subtasks.

This feature mirrors the Required Fields functionality from Toggl Track, now available in Toggl Focus.

Who can configure Required Fields?

Only workspace admins and organization admins can enable or disable required fields. Regular members cannot change these settings but must comply with them when creating or editing tasks.

How to enable Required Fields

Go to Settings in your workspace
Navigate to the Required Fields section
Toggle on the fields you want to make mandatory
Click Save

Currently supported required fields:

Tags -- require users to select at least one tag when creating a task
Project -- require users to assign a project to each task

More field types (priority, estimate, billable state and Custom Fields) are planned for future releases.

What happens when Required Fields are enabled

Creating tasks

Users will see required fields marked with an asterisk (*). The task cannot be saved until all required fields are filled in. Empty required fields are highlighted with an error state.

Subtasks

Required fields validation also applies to subtasks. A subtask cannot be created without filling in the required fields.

Browser extension

The browser extension supports required fields. If tags or project are required, users must select them in the extension before creating a task. The extension was updated alongside this release to support tag selection.

Tasks created before enabling Required Fields

Tasks that were created before required fields were turned on remain editable without filling in the newly required fields. However, starting a time entry on these older tasks will fail until the required fields are added to the task.

Important notes

Premium feature: Required Fields is available on the Premium plan and above. If your workspace is on a free plan, you will not see this option in Settings.
Gating matches Track: If a feature is gated in Track, the same gating applies in Focus.
Mobile app: The mobile app does not yet fully support all required field types. If tags are set as required, users may need to use the web app or browser extension to create tasks until mobile support is added.
API and bulk operations: The backend enforces required fields validation on all task creation endpoints, including bulk create/update. API consumers will receive a 422 error with details on which tasks are missing required fields:

{
  "error": "required_fields_missing",
  "error_description": "Please fill in all required field(s) to proceed: task 1: tags; task 3: tags"
}

FAQ

Can I make different fields required for different projects?

Not currently. Required fields are configured at the workspace level and apply to all tasks across all projects. Project-level required fields may be considered in future iterations.
What happens if I turn off a required field after it was enabled?

The constraint is removed immediately. Users can create and edit tasks without that field going forward. Existing tasks are not affected.
Will this affect tasks created by integrations or the AI assistant?

Yes. The backend enforces required fields on all task creation endpoints. Integrations and AI-generated tasks that don't include the required fields will receive a validation error and need to be updated to include them.
Can regular members see which fields are required?

Yes. Required fields are visually indicated in the task creation flow (asterisks, error borders). Members just cannot change which fields are required.