Customize Issue Fields

YouTrack provides a predefined set of issue fields that can be used out of the box, but they are all 100% customizable. Define your own States, Priority, and Types; add an Estimation, Remaining effort, or Spent time. Use fields types like Enumeration, Date, String, Int, User, Group, Version, State, Build and Subsystem to reflect everything your issues are about.

Edit Custom Field Values

Project administrators can add values to custom fields from anywhere - on the agile board and backlog, from the issues list, and in full page view. You can set the name, description, and assign a color to the new value. This feature saves you a lot of time configuring your projects.

Share Custom Fields Across Your Projects

Share custom fields across multiple projects along with their set of values, or define your own set of values specifically for each project. For example, you may share State and Priority, and have your own Verified by or Current Owner field.

First Class Citizens

Any custom fields you create are fully supported in search queries, commands and reports. They can be imported from any issue tracker, exported to a CSV file, and managed via REST API.

How to Use Custom Fields

Apart from customizing your issues attributes along with their values, custom fields allow you to:

  • Configure defaults for a new issue.
  • Add aliases to be used in search queries and commands. For example, for is the alias for Assignee field.
  • Set a custom field as required on project level.
  • Clone the Enumeration set of values.
  • Change the order of issue fields on project level.
  • Set field privacy.
  • Grant access to custom issue fields to particular user groups.

Use Custom Workflows to Reflect Your Process

With powerful and flexible workflows you are free to automate the lifecycle of issues in your project according to your specific needs. With workflows, you can easily notify teams about events, enforce policies, execute periodic tasks, integrate YouTrack with external tools, and support existing business processes.

For example, you may want:

  • The team lead to be able to assign issues in your project.
  • Send a notification to the team lead/group of users when an issue exceeds its due date.
  • Describe the mechanism of state's transition for the issues in your project.
  • Setup integration with Slack, or another service.

All of these, and much more can be performed using the workflows.

What's a Workflow?

A workflow is a set of rules that can be attached to a project. These rules define a lifecycle for issues in a project and automate changes that can be applied to issues. A workflow can contain one or several rules, but you can choose which combination of rules you want to activate in different projects.

Create Your Own Workflows

You can use JavaScript to create a workflow in your IDE or make workflows from scratch with the web-based workflow editor, available inside YouTrack. Once the workflow is ready, simply pack it into a Zip file and upload it to YouTrack.

Please refer to the documentation to get started.

Join YouTrack Workflow Community in Slack to exchange knowledge about workflows in YouTrack.

Use Existing Workflows

YouTrack comes with a set of ready-to-use workflows that can be easily attached to your projects ‘as is’ and handle common use cases. For example, close the parent issue when all its subtasks are resolved; raise issue priority after a certain time period; manage duplicates; implement a work timer; and much more. If you don’t find the workflow you need among the bundled ones, browse our Workflow Repository.

YouTrack Speaks Your Language

YouTrack is available in English, French, German, Russian, Japanese, and Spanish. You can even create your own translations for any other languages you need. YouTrack provides localization on a server level, so you can easily roll out your language to all your users.

YouTrack also has the option to choose the display language on a per-user basis in the user profile page. In this case, the language that is used in search queries, commands, and custom fields is set at the global level, but the page headers, menus, and controls are displayed in the user’s preferred language.

Workspace settings

Workspace options let you preview and choose how YouTrack looks for you personally: choose between light and dark schemes, and adjust the field and link panel positions as you see fit.

Customize Your Notifications

Customize Notification Templates

Customize email and jabber notifications to suit your user communication requirements. Choose how to alert your users when a new issue is created, updated, commented or reassigned. Add your own subject, change the language, tailor the message text, and more.

Per Project Notification Templates

Want to practice an individual approach to your users from various projects? Configure custom notifications templates on the project level. Set up multi-language notifications or completely redesign them for each project.

Issue Digest

With the Issue Digest notification scheme, you receive a single combined notification when an issue is created or updated so your email doesn’t get cluttered. If you prefer to be notified of each issue change as it happens, the Individual notifications scheme is available as well.

Customizable user profiles

In addition to user credentials, emails, and names, Administrators in YouTrack can let users enrich their user profiles by adding custom attributes. These attributes can be used to store various information, including the employee start date, employee ID, office location, job title, phone number, and much more.

Сustom attributes can be synchronized with your Active Directory server or accessed via REST API or in YouTrack workflows, which opens up even more possibilities for automating your process.