YouTrack Standalone 2018.3 Help

Configure a Project

When you create a project, YouTrack opens to the project overview page. This page is also displayed when you select a project from the Projects list.

YouTrack project overview

The project overview page gives you quick access to project administration pages.

Project Team

The project team is created automatically when the project is created. The user who created the project is automatically added to the team. Users and groups that are added to the project team are granted the Developer role in the project. For more information, see Manage the Project Team.

When you add users and groups to the project team, these changes are synchronized with the set of values for the Assignee field in the project.

  • Single users who are added to the project team are added to the set of values for the Assignee field in the project.

  • Groups that are added to the project team are also added to the set of values for the Assignee field in the project. Each member of the group can be set as the assignee for an issue in the project.

Users and groups who are removed from the project team are not removed from the set of value for the Assignee field. For more information, see Manage Assignees.

General Project Settings

To access the project settings, click the Edit project link on the project profile page. This opens the Edit Project page to the General tab.

General project settings

The General tab displays the settings that define your project. Here, you can edit the settings to add or change information that was stored when the project was created.

You can also set the email address that is used to send notifications for issues in this project.

Setting

Description

Name

The name of the project. The project name must be unique.

ID

The project ID. This value is used as a prefix for the issue ID in all of the issues that are assigned to this project. The project ID must be unique.

Description

An optional description that explains what the project is meant to organize or accomplish. This information is displayed on the project overview page. You can format your project description with Markdown.

This setting supports the standard Markdown implementation as described in the the CommonMark specification. Many of the extensions that are supported in issue fields are not available here. For details, see Markdown Syntax.

Project lead

The user who is responsible for the project. The user who created the project is set as the project lead automatically.

To change the project lead, select another user from the drop-down list.

From address

The email address that is used to send notifications for issues in this project. This sets the value for the "From:" field in the email header. You can either use the format sender name <email@yourdoman.com> or enter an email address without the sender name. If you do not set a value, notifications are sent from the address that is set as the global default in YouTrack.

For more information, see From and Reply-to Addresses.

Reply-to address

An optional address to which email replies are sent. This sets the value for the "Reply-To:" field in the email header for messages that are sent by YouTrack. Use this setting when, for example, the address that you use to send email notifications cannot receive replies.

If you do not set a value, replies are sent to the address from which the message was sent.
  • If you set the value for the From address in the project, replies are sent to this address.

  • If you leave the From address empty, replies are sent to the address that is set as the global default in YouTrack.

Additional Project Settings

On the Edit Project page, you have access all of the settings for your project including custom fields, time tracking options, notification templates, integrations, and workflows. These settings are organized on tabs that are specific to each feature.

Tab

Description

Access

Manage project access for specific users and groups. For more information, see Manage Project Access.

Team

Add users or groups to the project team. For more information, see Manage the Project Team.

Fields

Customize the fields and values for issues in the project. YouTrack provides a set of predefined default fields, such as State, Priority, and Assignee. These fields are attached automatically to any new project created in YouTrack. You can edit or delete most predefined fields or create and attach new custom fields. For more information, see Manage Custom Fields.

VCS

Integrate the project with a VCS repository, such as GitHub, GitLab, or BitBucket. For more information, see Connect to a VCS.

Notification Templates

Configure the notification templates for your project. For more information, see Edit Notification Templates.

Build Server Integration

Select an existing connection or add a new connection to a TeamCity server. You can configure the mapping between the project and the TeamCity configuration. For more information, see Integrate with TeamCity.

Time Tracking

Enable time tracking for your project to let your team log their work for issues, track issue progress, and create time reports. For more information, see Enable Time Tracking.

Workflow

Attach workflows to the project. As with fields, you have a set of predefined default workflows. Some workflows are auto-attached to new projects. In the Workflow tab, you can view the list of attached workflows, detach unnecessary workflows, and activate or deactivate workflow rules. For more information, see Manage Workflows.

Last modified: 16 November 2018