Skip to end of metadata
Go to start of metadata

Notifications are message you receive in your Bitbucket Inbox or, if enabled, via email.  You receive notifications about activity that takes place in your account or about things you watch. You can watch objects that belong to you or objects that belong to other accounts you have access to like a team.  

You can also configure a per-repository mailing list for issues.  For information on setting up mailing lists, see Setting email preferences for an issue tracker

Understand how notifications work

Notifications always go to your Bitbucket Inbox. They also appear in your Dashboard newsfeed and, if you enable it, in your email.  Bitbucket always notifies you when:

  • Another user mentions you in a comment.
  • Another user sends you an email.
  • Your access to a repository or team changes.

You can't turn off these notifications. You can configure whether these notifications also go to your email. 

For each repository, you can select categories of objects or specific instances of objects, you want to be notified about.  Bitbucket notifies you when these objects get created or updated.  For example, you can watch for all the pull request activity in the tutorials.bitbucket.org repository. Or, you can watch only the pull request the user tutorials created in that repository.  

Bitbucket automatically sets some watches for you. For example, Bitbucket automatically sets watches for objects you create or objects with activities you participate in. For example, Bitbucket automatically sets a watch for:

  • for any repository you create 
  • any pull request you create
  • issues or pull requests you comment on
  • any commit you make

Any single repository encompass many objects and activities often too numerous to watch individually.  So, when you create a repository, Bitbucket assumes you want to receive notifications about every object created in or action occurring in that repository – regardless of which user initiates the action.  So, by default, Bitbucket configures the repository notifications so that you get notified when you or another user:

  • Creates or updates a pull request. Updates include new commits, comments, and workflow changes.
  • Pushes a commit or comments on an existing commit.
  • Forks the repository.
  • Creates a new issue or updates an existing one.  Updates include new comments, updates, and transitions through the workflow.
  • Changes the Wiki by creating a new page or updating an existing one.

These repository-wide notifications all go to your Inbox unless you have email enabled, then, you get email too.  You can turn these repository-wide notifications off on a per-repository basis. You can also turn them off globally.

Finally, you can set watches on individual objects you have interest in.  You do this using the watch   button or link for the object.

Configure repository-wide notifications

  1. Log into your Bitbucket account.
  2. Navigate to the repository.
  3. Click the watch   button in the right corner of the screen.
    The system displays the repository watch dialog:
  4.  Select the repository-wide objects to watch under the Subscribe to notifications about section.
    You'll notice, this section is only active if you are watching the repository.   Also, this section only shows the objects you have permissions to see.

Watch or stop watching an object

You can also set your own watches on your account objects or other user's objects.

  1. Log into Bitbucket.
  2. Navigate to the object.
  3. Click the watch   button or the watch this link.

You can also manage your watches from the Manage Account page.

  1. Log into your Bitbucket account. 
  2. Choose Manage Account from the account menu.
  3. Select Notifications from the left hand navigation.
    The Notifications page displays. 
     
  4. Press the Manage link you want in the You are watching section.
  5. Press the  button on an individual object to stop watching it.
  6. Press Close when you are done.

Enabling or disabling email

Email notifications go to your primary email.  If you have multiple email addresses defined for your account, they do not receive notifications.

  1. Navigate to the Manage Account page.
  2. Select Notifications from the left hand navigation.
  3. Depending on your current setting you can Enable email or Disable email.
    When email is disabled, the Email me about settings are hidden.  You still receive notifications about these things in your Inbox.

When I follow a user do I get notifications about that user?

Following a user not the same as watching an object.   When you follow a user, that user's activities appear on your Dashboard. You'll never receive notifications about a user you follow.