Overview
CircleCI allows you to customize notification settings on a per-organization basis. This guide shows you how to locate your organization in the notifications settings and configure email preferences for each organization you belong to.
Prerequisites
Before configuring organization notification settings, ensure that:
You have a CircleCI account with access to at least one organization
You are following at least one project within the organization you want to configure
Note: The requirement to follow a project is related to CircleCI permissions, not your Version Control System (VCS) permissions. Even if you have access to repositories in your VCS provider (GitHub, Bitbucket, or GitLab), you must follow projects in CircleCI to see organization-level notification options.
Steps to Access Notification Settings
Step 1: Open User Settings
Log in to the CircleCI web app
Click your user icon in the top-right corner of the page
Select User Settings from the dropdown menu
Step 2: Navigate to Notifications
In the User Settings sidebar, click Notifications
Step 3: Locate Your Organization
On the Notifications page, you will see:
Default email address – Used for mandatory communications (system and security messages, billing and account updates, and deprecation notices)
Organization list – A table showing each organization (Org) and the associated email address
Each organization you belong to appears in this list, allowing you to configure notification preferences separately for each one.
Configuring Email Preferences
Email Notification Categories
You can configure your preferences for two different notification categories:
Category | Description |
My work | Receive an email every time a build you triggered finishes |
Followed projects | Receive emails for any build that has finished in a project you have followed |
Build Status Filters
You can further filter the notifications you receive based on the status of the build:
On default branch (any status) – Notifications for all builds on the default branch
Failed – Notifications when builds fail
Succeeded – Notifications when builds succeed
Cancelled – Notifications when builds are cancelled
Unauthorized – Notifications for unauthorized builds
Error – Notifications when builds encounter errors
Setting a Different Email Address per Organization
If you are a member of multiple organizations, you can specify a different email address for each one:
Find the organization in the notification settings table
Click the Email address dropdown next to the organization name
Select your preferred email address from the list of verified emails
📸
Screenshot: Email Dropdown
Email address dropdown expanded showing available email options
Select a different email for each organization using the dropdown
Tip: Ensure any secondary email addresses are verified on your VCS provider (GitHub, Bitbucket, or GitLab) before using them for CircleCI notifications.
Enabling Web Notifications
In addition to email notifications, you can enable browser-based web notifications:
Scroll to the bottom of the Notifications page
Toggle Web Notifications to on
When your browser prompts you, click Allow to permit notifications
Troubleshooting
Organization Not Appearing in Notification Settings
If your organization does not appear in the notification settings:
Verify you have access to the organization in your VCS provider
Follow at least one project in that organization on CircleCI
Refresh the page after following a project
Not Receiving Notification Emails
If you are not receiving expected notification emails:
Check that you have enabled the appropriate notification categories (My work or Followed projects)
Verify the correct status filters are selected (Failed, Succeeded, etc.)
Verify the correct email address is selected for the organization
Check your email spam/junk folder
Ensure your email address is verified on your VCS provider
Try refreshing your permissions from User Settings