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.

Bitbucket Server 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 STATE CHANGES or ALL ACTIVITY

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 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 recieve 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 Server), 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 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 Apr 24, 2018

Was this helpful?

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