How to Find Your Organization in Notification Settings

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

1. Log in to the CircleCI web app
2. Click your user icon in the top-right corner of the page
3. Select User Settings from the dropdown menu

Step 2: Navigate to Notifications

1. In the User Settings sidebar, click Notifications

Step 3: Locate Your Organization

On the Notifications page, you will see:

1. Default email address – Used for mandatory communications (system and security messages, billing and account updates, and deprecation notices)
2. 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:

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:

1. Find the organization in the notification settings table
2. Click the Email address dropdown next to the organization name
3. Select your preferred email address from the list of verified emails

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:

1. Scroll to the bottom of the Notifications page
2. Toggle Web Notifications to on
3. 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:

1. Verify you have access to the organization in your VCS provider
2. Follow at least one project in that organization on CircleCI
3. Refresh the page after following a project

Not Receiving Notification Emails

If you are not receiving expected notification emails:

1. Check that you have enabled the appropriate notification categories (My work or Followed projects)
2. Verify the correct status filters are selected (Failed, Succeeded, etc.)
3. Verify the correct email address is selected for the organization
4. Check your email spam/junk folder
5. Ensure your email address is verified on your VCS provider
6. Try refreshing your permissions from User Settings

Additional Resources

• Notifications Overview (Official Documentation)
• Troubleshooting Secondary Email Notifications