Repository notifications

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

You can watch a repository by visiting the source page of the repository and clicking the watch button. From here you can select which events to watch.

The watch button will only be visible if an email server has been configured in Bitbucket Data Center. For information on how to do this see Setting up your mail server.

Bitbucket sends email notifications to the watchers of a repository when the following events occur.


Pull request eventNotification recipients
A pull request is openedThe watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY
A pull request is mergedThe watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY
A pull request is declinedThe watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY
A pull request is reopened

The watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY

A pull request is deletedThe watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY
The pull request is approvedThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
The pull request is unapprovedThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
A commit is made to a pull request source branchThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
The destination branch is changedThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
A comment is addedThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
A comment is replied toThe watchers of the repository with a pull request notification scope of ALL ACTIVITY
A commit is pushed to the repository on the default branchThe watchers of the repository with a push notification scope of DEFAULT BRANCH
A commit is pushed to the repository on a non-default branchThe watchers of the repository with a push notification scope of DEFAULT BRANCH or ALL BRANCHES
Auto-merge is requested for a pull request

The watchers of the repository with a pull request notification scope of ALL ACTIVITY

Auto-merge is canceled for a pull requestThe watchers of the repository with a pull request notification scope of ALL ACTIVITY

A draft pull request is created

The watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY

A draft pull request is opened for review

The watchers of the repository with a pull request notification scope of ALL ACTIVITY

An open pull request is converted to a draft

The watchers of the repository with a pull request notification scope of ALL ACTIVITY

Pull request notifications

The below notification scopes are available for pull requests when watching a repository.

Notification scopeExplanation
All activityNotifications will be sent for all pull request activity within the repository.
State changes

Notifications will only be sent for pull request state changes (opened, merged, declined, reopened, deleted) within the repository.

NoneNo notifications will be sent for pull requests within the repository (for pull requests you are not watching).

Note that if you're watching a particular pull request, this takes precedence over your repository pull request notification scope. For example, if you are watching a repository with the state changes pull request option selected, and are watching a particular pull request, you will receive all notifications for that pull request, and only state change notifications for other pull requests.

Notifications for a pull request being deleted are only sent to immediate repository watchers (and watchers of the pull request). Batched repository watchers will not receive this notification.

Push notifications

The below notification scopes are available for pushes when watching a repository.

Notification scopeExplanation
All branchesNotifications will be sent for all pushes to the repository.
Default branchNotifications will be sent for pushes to the default branch of the repository.
NoneNo notifications will be sent for pushes to the repository.

A notification will only be sent if a push adds or removes at least one commit. If the push updates one or more refs without actually adding or removing a commit (e.g., pushing a new tag to a commit already in the repository on Bitbucket), then no push notification will be sent.


If you watch a repository and a specific pull request within it, you will receive pull request notifications for that pull request.

Your repository notifications will not include this pull request. Repository notifications about pull requests will only be sent for pull requests you are not watching.

You can manage all of your watched repositories in your Bitbucket personal account settings (on the Watched repositories tab).

By default, repository notifications are batched. You can change your personal account settings (on the Notification settings tab) so that you get all repository notifications immediately. 

You don't receive notifications for events you initiate yourself.

Last modified on Jan 30, 2024

Was this helpful?

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