Skip to main content

Notification Preferences

What are notification preferences?​

Notification preferences control which email notifications you receive from Phobos. You can configure them at three levels: global, per-organization, and per-project. Each level can inherit from the one above it or be set independently.

Have a question?

Check the FAQ to see if there's already an answer.

Preference scope options​

Phobos provides four scope options that determine which notifications you receive:

  • ALL: receive notifications for all events, regardless of whether you are involved.
  • PARTICIPATE: receive notifications only for events you are directly involved in. For example, a pipeline you triggered that fails, or a release you created.
  • CUSTOM: choose specific event types to be notified about.
  • NONE: do not receive any notifications.

The default preference for all new users is PARTICIPATE.

Custom event options​

When the scope is set to CUSTOM, you can select one or more of the following events:

  • Failed pipeline: a pipeline you are involved in has failed.
  • Release created: a new release has been created.
  • Release completed: a release has finished all of its deployments.
  • Membership change: a member has been added to or removed from an organization or project.

At least one event must be selected when using the CUSTOM scope.

important

If the scope is set to CUSTOM and no events are selected, the preference cannot be saved.

Preference levels​

Notification preferences follow an inheritance chain:

  1. Global: applies to everything by default.
  2. Per-organization: overrides the global preference for a specific organization.
  3. Per-project: overrides the organization (or global) preference for a specific project.

The most specific level always takes priority. If no override is set at the organization or project level, the preference is inherited from the level above.

Viewing notification preferences​

To view your global notification preference, click on your profile icon in the top-right corner and select Preferences. The Notifications section displays your current global scope.

For organization and project preferences, navigate to the target organization or project. The notification bell icon displays your current preference for that scope. If the preference is inherited, it will indicate where it is inherited from (e.g., "Inherited from global preference" or "Inherited from [organization name]").

Configuring global preferences​

The global preference is your default notification setting. It applies to all organizations and projects unless overridden at a lower level.

  1. Click on your profile icon in the top-right corner and select Preferences.
  2. In the Notifications section, click on the notification bell icon.
  3. Select Change Preference.
  4. Select a scope: ALL, PARTICIPATE, CUSTOM, or NONE.
  5. If you selected CUSTOM, check the events you want to be notified about.
  6. Click Save.

Configuring per-organization preferences​

You can set a notification preference for a specific organization. This overrides your global preference for that organization and all projects within it (unless a project has its own override).

  1. Navigate to the target organization.
  2. Click on the notification bell icon.
  3. Select Change Preference.
  4. Uncheck Inherit notification preference from parent to set your own preference.
  5. Select a scope: ALL, PARTICIPATE, CUSTOM, or NONE.
  6. If you selected CUSTOM, check the events you want to be notified about.
  7. Click Save.

To revert to the global preference, check Inherit notification preference from parent and click Save.

Configuring per-project preferences​

You can set a notification preference for a specific project. This overrides the organization and global preferences for that project only.

  1. Navigate to the target project.
  2. Click on the notification bell icon.
  3. Select Change Preference.
  4. Uncheck Inherit notification preference from parent to set your own preference.
  5. Select a scope: ALL, PARTICIPATE, CUSTOM, or NONE.
  6. If you selected CUSTOM, check the events you want to be notified about.
  7. Click Save.

To revert to the organization's preference, check Inherit notification preference from parent and click Save.

Frequently Asked Questions (FAQ)​

Who can configure notification preferences?​

Any user can configure their own notification preferences. There are no role or permission requirements. Notification preferences are personal settings and do not affect other users.

What is the default notification setting?​

PARTICIPATE. You receive notifications only for events you are directly involved in.

Can I turn off all notifications?​

Yes. Set your global preference to NONE. This stops all notifications unless a specific organization or project has its own override set to a different scope.

What does "inherited" mean?​

When a preference is inherited, it means the organization or project is using the setting from the level above (global or organization) rather than its own. The notification bell icon will indicate where the preference is inherited from.

Can I override an inherited preference?​

Yes. At the organization or project level, uncheck Inherit notification preference from parent in the preference dialog. You can then choose your own scope. You can revert to inheriting at any time by checking it again.

Who receives notifications for approval rules?​

Approval rule notifications are separate from notification preferences. When a pipeline task requires approval, the designated approvers always receive a notification regardless of their preference settings. Learn more about Approval Rules.