YouTrack Cloud 2022.2 Help

Manage Workflows for Multiple Projects

As a system administrator, you can manage workflows in all of the projects for your YouTrack instance. Users who have a project administrator role can only manage workflows in the projects for which they have permission to view and update the project. For more information, see Manage Workflows.

Attach a Workflow to a Project

To use a workflow, you need to attach it to one or more projects. From the Administration menu, you have access to all of the projects in YouTrack.

To attach a workflow:

  1. From the Administration menu, select Workflows.

  2. Select the workflow from the list.

  3. If the sidebar is hidden, click the Show Details button.

  4. In the sidebar, click the Projects list and select the projects where you want to apply the workflow.

    Attach workflow to selected projects.
    • The workflow is attached to all of the selected projects.

    • If there are projects that do not meet the workflow requirements, the requires setup flag is shown.

The requires setup flag indicates that there are requirements that are specified in the workflow that are not available in one or more projects to which the workflow is currently attached. This can mean that the project does not use the required custom fields, values are missing from the set of values in a custom field, or there are issue link types that have not been created in YouTrack. The names of each of the projects that require setup are displayed in red in the Details sidebar.

In most cases, these fixes can be applied without leaving the workflow administration page.

To fix setup problems with workflows:

  1. Select the workflow in the list.

  2. Select the first rule that is marked with the requires setup flag without opening the module in the workflow editor. Meaning, select the rule without clicking the link for the module name.

  3. If the sidebar is hidden, click the Show Details button.

  4. Move the pointer over any of the projects that are displayed in red text.

    • A tooltip displays the changes that are required to activate the workflow in each project.

    Attach workflows requires setup.
  5. If you want to fix the problems in all projects at once, click the Auto-fix all button. This opens the Workflow Auto-fixes dialog.

    The Workflow Auto-fix dialog.

    If there are any projects where you don't want to apply this fix, clear the selection for the corresponding update.

    To fix the problems for a particular project, click the Apply fixes link. This opens the Apply fixes dialog

    Attach workflows apply fixes.

    Select all of the required fixes, then click the Apply button.

    • When done, the requires setup flag is automatically removed from each rule.

    • If the problems are resolved for all of the projects that use the workflow, the requires setup flag is removed from the workflow.

Detach and Attach Workflow Rules

When you attach a workflow to a project, all of the rules are attached and enabled. You can customize the workflow on a per-project basis by detaching and attaching specific rules.

To view a the status for each rule in a workflow, select the workflow from the list. Rules that have been detached from all projects show No usages in the Usages column.

Activate workflow rule no usages.

To deactivate individual rules in a project:

  1. From the Administration menu, select Workflows.

  2. Select a workflow from the list.

  3. Click the project selector for the rule that you want to deactivate.

  4. Clear the selection for the projects where you want to deactivate the rule.

    Detach workflow rule in project.

When you deactivate all of the rules in a workflow, the workflow is detached from the project automatically.

To activate individual rules in a project:

  1. From the Administration menu, select Workflows.

  2. Select a workflow from the list.

  3. Click the project selector for the rule that you want to deactivate.

  4. Select the projects where you want to activate the rule.

    Attach workflow rule in project.

Detach Workflows

If you no longer want to use a workflow, you can detach it from one or more projects.

To detach a workflow:

  1. From the Administration menu, select Workflows.

  2. Select the workflow that you want to detach.

  3. In the Details sidebar, click the project selector for the workflow.

  4. Clear the selection for the projects where the workflow is attached.

    Detach workflow from project.

Alternatively, you can deactivate all of the rules in the workflow. The workflow is detached from the project automatically.

Last modified: 14 July 2022