Notifications

Helix TeamHub creates notifications for events. This section describes the type of notifications you can receive, how to subscribe to them, the events that trigger them, and the notification messages that are created.

Notification types

TeamHub offers the following notifications:

  • In-app: Work inside the application
  • Email: Are sent to your email address

You can access the latest notifications from the bell icon in the site header.

Notifications

Clicking a notification opens the source, displaying the notification in context.

To receive notifications from projects, repositories, code reviews, and issues, you need to watch them. To watch an item in TeamHub, go to the respective tab and click the watch icon. To stop watching an item, click the crossed-out watch icon again.

Watch a repository

By default, you watch each project, repository, code review, and issue you have created or been added to. In addition, TeamHub subscribes you to watching an item when you leave a comment or push changes to a repository.

Notification events and messages

This section contains a list of the events that trigger notifications and example notification messages:

Attachments

  • Attachment created for a code review:
  • John created an attachment image1.png in code review !123

  • Attachment created for a Multi-Repo Code Review:
  • John created an attachment image1.png in multi-repo code review !123

  • Attachment created for a Task:
  • John created an attachment image1.png in issue #123

Code Reviews

  • Review created:
  • John created a code review in repo1 repository

  • Updated description, state, or title:
    • John updated code review description: John's updated description text
    • John updated code review state to approved
    • John changed code review title to MyReview
  • Setting the 'require passing build' flag:
    • John enabled build requirement
    • John disabled build requirement
  • Setting the 'all tasks to be resolved' flag:
    • John enabled task comments requirement
    • John resolved task comments requirement
  • Updated the number of approvals required:
  • John changed code review threshold to 10

  • New commits pushed to a head branch:
  • John pushed 5 new commits to feature-01 branch

  • New reviewer:
    • John joined reviewers
    • John added Kate to reviewers
  • Reviewer removed:
    • John left reviewers
    • John removed Kate from reviewers
  • Reviewer voted:
  • John approved the review

  • Reviewer cleared vote:
  • John withdrew their approval

Comments

  • Code review comment:
    • John created the task comment in the code review: My task comment
    • John commented on the code review: My comment
  • Code review file comment:
    • John created the task comment in the code review, repo1/foo: My comment
    • John commented on the code review, repo1/bar: My comment
  • Code review line comment:
    • John created the task comment in the code review, repo1/bar:10: My comment
    • John commented on the code review, repo1/foo:55: My comment
  • Repository commit comment:
  • John commented on the commit 0eb219d6a9193251f7ef7d921f5dc96cf15ec25e: My comment

  • Repository commit file comment:
  • John commented on the commit 0eb219d6a9193251f7ef7d921f5dc96cf15ec25e, repo1/foo: My comment

  • Repository commit line comment:
  • John commented on the commit 0eb219d6a9193251f7ef7d921f5dc96cf15ec25e, repo1/foo:10: My comment

  • Task comment:
  • John commented on the issue: My comment

Multi-Repo Code Reviews

  • Created a Multi-Repo Code Review:
  • John created a multi-repo code review in repo1 project

  • Updated description, state, or title:
    • John updated multi-repo code review description: My updated description
    • John updated multi-repo code review state to merged
    • John changed multi-repo code review title to My review title

Tasks

  • Created a task:
  • John created issue in Milestone 1 milestone

  • Updated description, state, or title:
    • John updated issue description: My updated description
    • John updated issue state to closed
    • John changed issue title to My task title
  • Created/deleted a member:
    • John joined the issue
    • John assigned Kate to the issue
    • John left the issue
    • John removed Kate from the issue
  • Milestone update:
  • John moved issue to Milestone 4 milestone