Repository notifications

Notifications

On this page

Related content

Still need help?

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.