Repository notifications
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 and Server. 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 event | Notification recipients |
|---|---|
| A pull request is opened | The watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY |
| A pull request is merged | The watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY |
| A pull request is declined | The 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 |
| A pull request is deleted | The watchers of the repository with a pull request notification scope of STATE CHANGES or ALL ACTIVITY |
| The pull request is approved | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| The pull request is unapproved | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| A commit is made to a pull request source branch | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| The destination branch is changed | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| A comment is added | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| A comment is replied to | The watchers of the repository with a pull request notification scope of ALL ACTIVITY |
| A commit is pushed to the repository on the default branch | The watchers of the repository with a push notification scope of DEFAULT BRANCH |
| A commit is pushed to the repository on a non-default branch | The watchers of the repository with a push notification scope of DEFAULT BRANCH or ALL BRANCHES |
Pull request notifications
The below notification scopes are available for pull requests when watching a repository.
| Notification scope | Explanation |
|---|---|
| All activity | Notifications 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. |
| None | No 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 scope | Explanation |
|---|---|
| All branches | Notifications will be sent for all pushes to the repository. |
| Default branch | Notifications will be sent for pushes to the default branch of the repository. |
| None | No 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.