Default tasks

Default tasks allow project and repository admins to configure a list of tasks which are automatically created when a pull request is opened. These tasks allow admins to set consistent processes for developers to follow when working on pull requests.

The No incomplete tasks merge check can be used to prevent pull requests with incomplete default tasks from being merged. And when you change the target branch on a pull request, the default tasks on the pull request are also updated.

You can define default tasks from the project or repository settings page. When admins create default tasks at the project level, all repositories in the project will inherit the default tasks in their repository settings. Repository admins can’t overwrite or remove inherited tasks. Admins can add additional tasks that are specific to the repository in the repository settings.


On this page



Create a default task

You must be an admin with project or repository permissions to create default tasks for projects or repositories.

If a default task exists at the project level, you cannot create the same task as the repository level. We detect duplicates by checking the source and target branches, as well as the description (including all formatting).

To create default tasks for projects or repositories:

  1. From either the Project or Repository settings, select Default tasks.

  2. Select Add a default task.

  3. Enter the task details in the Default task description field.

    Markup, emojis, and @mentions are all supported in the description and will be rendered when the task is created.

  4. You can configure the default task to only apply for certain pull requests when they are opened by setting a specific source and target branch. If you would like the default task to apply to all pull requests, select Any branch for both source and target branch. Learn more about branching models
  5. Select Save.

View default tasks

Default tasks are displayed on the pull request overview page under the user Bitbucket.

To view default tasks, navigate to your pull request and look at its Activity.

When reviewing the pull request, you may also view them by selecting the Open tasks list button.

Edit or delete a default task

You must be an admin with project or repository permissions to edit or delete default tasks for projects or repositories.

  1. From either the Project or Repository settings, select Default tasks.

  2. Select the default task description link or select ••• > Edit or Delete for the specific task.

Note that:

  • edits will only apply to newly opened pull requests

  • deleting a default task will no longer create it when a pull request is opened. Pull requests previously opened will retain the deleted task

Last modified on Sep 24, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.