In Exchange Online, the default GAL is automatically maintained by Microsoft. You can create custom address lists and GALs for advanced tasks, but most organizations use the default Global Address List (GAL) without Address Book Policies (ABPs). ABPs are typically used when an organization needs to segment the GAL and address lists so that different groups of users see different sets of recipients.
Our tutorial shows how to view GAL in Outlook, manage address list permissions, and fix GAL not updating issues.
What is the Global Address List in Microsoft 365?
The Global Address List (GAL) is a searchable directory that contains all mail-enabled recipient objects in Exchange Online (Microsoft 365). GAL includes user mailboxes, contacts, mail-enabled users, mail-enabled groups, distribution groups, Microsoft 365 groups, public folders, etc.
Note. Modern Microsoft 365 clients (such as the new Outlook, Outlook on the web, Microsoft Teams, and Microsoft Search) may use additional Microsoft 365 services (including Microsoft Graph) to locate recipients. However, the Global Address List (GAL) remains the primary Exchange Online directory that determines recipient visibility and is the foundation for address book management.
How to View the Global Address List
In Outlook on the Web
To view GAL in Outlook on the web:
- Sign in to https://outlook.office.com/
- Click the People icon in the left navigation bar;
- Select Directory > Default Global Address List;
- A list of your organization’s recipients appears on the right.

In New Outlook for Windows
In the new Outlook for Windows, you can access the organization directory through the People view and directory search. Unlike classic Outlook in Cached Exchange Mode, New Outlook relies on Microsoft 365 online services rather than a locally downloaded Offline Address Book (OAB).
If a recipient appears in Outlook on the web but not in New Outlook, you need to compare the search scope and recipient details in both clients, then investigate client-side search/sync behavior before troubleshooting recipient provisioning. Traditional OAB download and cache troubleshooting primarily applies to classic Outlook for Windows.
In Outlook Desktop
Use the Address Book in Outlook Desktop:
Click the Address Book icon on the ribbon and select Global Address List. Here you can view the attributes of all mail-enabled recipients.

GAL vs Offline Address Book (OAB)
Admins often confuse the GAL with the OAB. It’s important to note that they are related, but designed for different purposes:
| Feature | GAL | OAB |
|---|---|---|
| Access | Online only | Available offline |
| Updates | Changes become visible after they are processed and synced in Exchange Online | The OAB is generated every 8 hours in Exchange Online; Outlook clients download updates separately, so cached data may remain outdated |
| Location | Exchange Online | Cached locally in Outlook |
| Used when | Looking up recipients against the current address list in Exchange Online, including in Outlook on the web | Looking up recipients using a locally downloaded copy of address list data in classic Outlook when Cached Exchange Mode is used |
The GAL is the online Exchange address list, while the OAB is a locally downloaded copy used by classic Outlook in Cached Exchange Mode. The OAB allows Outlook to look up recipients without retrieving every address book entry from Exchange Online in real time.
In classic Outlook running in Cached Exchange Mode, a new team member does not appear in the address book because the OAB has not yet updated.
You can force Outlook to download the latest OAB by navigating to Send/Receive tab → Send/Receive Groups → Download Address Book.
You can check the current OAB in Exchange Online using PowerShell command:
Get-OfflineAddressBook
Note that you must be connected to Exchange Online PowerShell and have sufficient permissions in order to use the Get-OfflineAddressBook cmdlet.
Default GAL and built-in address lists
By default, the new Exchange Online tenant comes with one GAL (called the Default Global Address List) and includes several built-in address lists such as All Contacts, All Distribution Lists, All Rooms, All Users, All-Groups, and Public Folders. Default Global Address List is the primary reference for all recipients in the organization.
Recipient filter used in the Default GAL
In order to inspect the recipient filter associated with the Default Global Address List in Exchange Online, connect to Exchange Online PowerShell and run:
Get-GlobalAddressList -Identity "Default Global Address List" |
Format-List Name,RecipientFilter
The RecipientFilter property shows the filter configured for the address list. You should not assume that a manually created GAL uses the same filter as the default GAL.
In most Exchange Online deployments, you don’t need to modify the default GAL. If a recipient is missing, you need to check its visibility settings, the relevant recipient filters, and any assigned Address Book Policy.
The Default Global Address List is built using a Microsoft-defined recipient filter that includes mail-enabled users, groups, contacts, public folders, and other supported recipient types.
How GAL Data Sync Works in Microsoft 365
Keep in mind that in Microsoft 365, the Global Address List (GAL) is not updated directly from on-premises AD. In hybrid environments, directory data follows this sync path On-prem Active Directory > Microsoft Entra Connect > Microsoft Entra ID > Exchange Online > Global Address List (GAL) / Offline Address Book (OAB).
Before changes (such as name, department, or mailbox attributes) appear in Outlook GAL/OAB, they must pass through this pipeline.
Before continuing, install the Microsoft Graph Users PowerShell module (run once):
Install-Module Microsoft.Graph.Users -Scope CurrentUser
Now connect to Microsoft Graph:
Connect-MgGraph -Scopes "User.Read.All"
To get users, use the command below:
Get-MgUser
Also, before troubleshooting Exchange Online, you should check if the object is present in Microsoft Entra ID. You can do this with the command:
Get-MgUser -UserId cyril@theitbros.com
In hybrid environments, you can also check if the object is synced from on-premises AD and when it was last synced:
Get-MgUser -UserId cyril@theitbros.com `
-Property DisplayName,OnPremisesSyncEnabled,OnPremisesLastSyncDateTime |
Select-Object DisplayName,OnPremisesSyncEnabled,OnPremisesLastSyncDateTime
Here are the key implications:
- GAL membership is determined by the recipient filter and the underlying recipient attributes. You can create custom GALs and config their filters, but they cannot manually add/remove individual recipients from a GAL independently of those filters and recipient properties.
- Updates depend on Entra Connect sync cycle.
- Exchange Online only reflects what exists in Entra ID.
- OAB updates are delayed and cached in Outlook.
Note that typical delays occur in:
- Typical sync interval depends on Entra Connect/Cloud Sync config.
- Exchange Online directory replication
- Outlook Offline Address Book download cycle
Note that even after sync completes in Microsoft Entra ID, Exchange Online may require additional time to propagate changes to the address book service and Outlook Offline Address Book (OAB).
Cross-tenant environments
In organizations using Microsoft Entra cross-tenant sync/multi-tenant Microsoft 365 deployments (for example, after mergers and acquisitions), recipient visibility may also depend on cross-tenant sync and provisioning. In these environments, during GAL troubleshooting you should include verification that the recipient has been synced into the target tenant.
How to Check If Recipient Exists in Exchange Online
Before troubleshooting Outlook or OAB issues, you need to verify that the recipient exists in Exchange Online.
For example:
Get-EXORecipient -Identity cyril@theitbros.com
The following command will help you to check if the object is represented as a UserMailbox, SharedMailbox, MailUser, MailContact, Microsoft 365 Group, or another recipient type:
Get-EXORecipient -Identity cyril@theitbros.com |
Select-Object Name,RecipientType,RecipientTypeDetails
To check whether a recipient is hidden from the GAL, use Get-EXORecipient to inspect the HiddenFromAddressListsEnabled property. This works for supported Exchange Online recipient types (including mailboxes, mail-enabled groups, mail contacts, and mail users).
Get-EXORecipient -Identity "cyril@theitbros.com" `
-Properties HiddenFromAddressListsEnabled |
Format-List DisplayName,RecipientTypeDetails,HiddenFromAddressListsEnabled
If HiddenFromAddressListsEnabled is True, the recipient is hidden from address lists. If it is False, the recipient is not hidden by this setting.
Important for hybrid environments. Before changing HiddenFromAddressListsEnabled, you need to check where the recipient’s Exchange attributes are managed. For directory-synchronized recipients whose Exchange attributes are managed on-premises, make the change using the supported on-premises Exchange management tools and allow directory sync to propagate it to Exchange Online. For cloud-managed Exchange attributes, use Exchange Online PowerShell. You should not assume that every directory-synced recipient must be managed on-premises; some environments use the IsExchangeCloudManaged feature to manage Exchange attributes in the cloud.
In case the recipient does not appear in Exchange Online, the problem is usually related to Entra Connect sync/missing Exchange attributes.
Checking Your Organization Customization Status
Before creating custom address lists, you need to check if organization customization is enabled in your Exchange Online tenant. Use the command below:
Get-OrganizationConfig | Format-List IsDehydrated
If IsDehydrated is True, you need to enable organization customization:
Enable-OrganizationCustomization
Note that this operation only needs to be performed once per Exchange Online organization. If IsDehydrated is False, customization is already enabled and you can proceed.
You need sufficient Exchange Online permissions in order to run these commands. If the cmdlet returns an error indicating that organization customization must be enabled, follow the instructions above before continuing.
Managing Address Lists in Exchange Online
The Address Lists role is used in Exchange Online to manage address lists. By default, this role is not assigned to any of the role groups. Assign this role to your account:
- Sign in to the Exchange Admin Center;
- Navigate to Roles > Admin Roles;
- Create a new role group. Give it any name (we use Address List Management).
- Assign the Address Lists role;
- Add your account to the list of members of this role.

Connecting to Exchange Online with PowerShell
After assigning the Address Lists role to your account, you need to connect to Exchange Online PowerShell.
First, you need to install the Exchange Online PowerShell module if it is not already installed. Use the latest supported version of the ExchangeOnlineManagement module.
Versions 3.10.0 and later require PowerShell 7.6.0 or later; Windows PowerShell 5.1 remains supported. Check the module’s compatibility requirements before installing or updating it.
Check the installed module version before connecting:
Get-Module ExchangeOnlineManagement -ListAvailable |
Select-Object Name, Version
To install the module for the current user if needed, run the command:
Install-Module ExchangeOnlineManagement -Scope CurrentUser
If you already have an active session, disconnect and reconnect so the updated role permissions are applied to the new session. Then verify that the required address list cmdlets are available. Use the commands below:
Disconnect-ExchangeOnline -Confirm:$false
Connect-ExchangeOnline
When you connected, use the cmdlets below to manage address lists. In order to perform these operations, you will require the Address Lists role that was assigned earlier.
To create a new address list for a specific department, use the following:
New-AddressList -Name "Sales Department" `
-RecipientFilter "Department -eq 'Sales'"
Listing available address lists and GALs
List the available address books:
Get-AddressList
To preview recipients matching an address list filter, run the command:
Get-Recipient -ResultSize Unlimited `
-RecipientPreviewFilter (Get-AddressList -Identity "Sales Department").RecipientFilter
Address Book Policies (ABP) in Exchange Online
Address Book Policies (ABP) provide you a way to control which users see which Global Address List and Address Lists in Outlook. ABPs allow user-level segmentation of the address book view (unlike Address Lists, which are only filters).
Keep in mind that ABPs provide logical address book segmentation only. They should not be considered a security boundary because users may still communicate with recipients outside their visible address lists if messaging permissions allow it. In hybrid environments, ABP behavior depends on synced recipient attributes from Microsoft Entra ID.
ABPs are useful in cases when you need to separate address book visibility between departments/user groups within the same Microsoft 365 tenant.
In Exchange Online, an ABP combines:
- Global Address List (GAL)
- Address Lists
- Offline Address Book (OAB)
- Room List
Create and Assign an Address Book Policy
Before creating an address book policy (ABP), you need to ensure that the required global address list (GAL), offline address book (OAB), room list, and additional address lists exist. The following example illustrates the process of creating a policy for Sales department users.
First, let’s create a GAL and an address list for the department. For production deployments, you should use a dedicated Exchange custom attribute to define which recipients belong to the Sales GAL. This allows admins to explicitly include the required mailboxes, groups, contacts, and other mail-enabled recipients instead of relying solely on the Department attribute, which may be missing/inconsistent.
The example below assumes that CustomAttribute15 is reserved for address book segmentation and has been populated with Sales for every recipient that should appear in the Sales GAL. Do not use this filter until you have populated and validated the attribute values.
New-GlobalAddressList -Name "Sales GAL" `
-RecipientFilter "CustomAttribute15 -eq 'Sales'"
New-AddressList -Name "Sales Mailboxes" `
-RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox' -or RecipientTypeDetails -eq 'SharedMailbox') -and (CustomAttribute15 -eq 'Sales'))"
Next, create a room address list. If you want to include all room mailboxes regardless of department, use the following filter:
New-AddressList -Name "Sales Rooms" `
-RecipientFilter "RecipientDisplayType -eq 'ConferenceRoomMailbox'"
Important. The Sales GAL filter includes only recipients whose CustomAttribute15 attribute is set to Sales. Users assigned to this GAL may not see recipients from other departments, such as HR, IT, or management, as well as external contacts and shared mailboxes whose CustomAttribute15 value is missing or different. Before assigning the ABP, you need to check if this visibility model matches your organization’s requirements. If Sales users must also see company-wide contacts, shared mailboxes, or other recipient types, adjust the recipient filter accordingly and validate the resulting recipient set.
Create an offline address book that includes the new GAL:
New-OfflineAddressBook -Name "Sales OAB" `
-AddressLists "\Sales GAL"
Now create the ABP by referencing the objects you created:
New-AddressBookPolicy -Name "Sales ABP" `
-GlobalAddressList "\Sales GAL" `
-OfflineAddressBook "\Sales OAB" `
-RoomList "\Sales Rooms" `
-AddressLists "\Sales Mailboxes","\Sales Rooms"
Finally, assign the policy to a mailbox:
Set-Mailbox -Identity "user@contoso.com" `
-AddressBookPolicy "Sales ABP"
Hide Other Recipient Types from the GAL
The Set-Mailbox cmdlet applies to mailboxes. To hide other recipient types from the global address list (GAL), you can use the corresponding Exchange Online PowerShell cmdlet.
In order to hide a Microsoft 365 Group, run the command:
Set-UnifiedGroup -Identity "Marketing Team" `
-HiddenFromAddressListsEnabled $true
Hide a distribution group or mail-enabled security group:
Set-DistributionGroup -Identity "Sales Team" `
-HiddenFromAddressListsEnabled $true
You can hide a dynamic distribution group from the GAL with the following command:
Set-DynamicDistributionGroup -Identity "Sales Dynamic Group" `
-HiddenFromAddressListsEnabled $true
To verify the setting, run the command:
Get-DynamicDistributionGroup -Identity "Sales Dynamic Group" |
Format-List Name,PrimarySmtpAddress,HiddenFromAddressListsEnabled
To make the dynamic distribution group visible in address lists again, set -HiddenFromAddressListsEnabled $false:
Set-DynamicDistributionGroup -Identity "Sales Dynamic Group" `
-HiddenFromAddressListsEnabled $false
To hide a mail contact:
Set-MailContact -Identity "External Consultant" `
-HiddenFromAddressListsEnabled $true
To hide a mail user:
Set-MailUser -Identity "External User" `
-HiddenFromAddressListsEnabled $true
To make any of these recipients visible in address lists again, you need to set -HiddenFromAddressListsEnabled $false using the same cmdlet.
To make a mailbox visible in the GAL again, run the command:
Set-Mailbox -Identity "cyril@theitbros.com" `
-HiddenFromAddressListsEnabled $false
For hybrid recipients, you need to verify where the relevant Exchange attributes are managed before changing their visibility settings.
In order to verify the setting, run the following:
Get-Recipient -Identity "External Consultant" |
Format-List Name,RecipientTypeDetails,HiddenFromAddressListsEnabled
Note that hiding a recipient from address lists does not prevent it from receiving email. The change affects its visibility in the GAL and other address lists.
Don’t forget to verify the policy config and mailbox assignment:
Get-AddressBookPolicy -Identity "Sales ABP" |
Format-List Name,GlobalAddressList,OfflineAddressBook,RoomList,AddressLists
Get-EXOMailbox -Identity "user@contoso.com" `
-Properties AddressBookPolicy |
Format-List DisplayName,AddressBookPolicy
You need to replace the example names, recipient filters, and mailbox identity with values appropriate for your organization. The Address Lists management role is required for these address-book cmdlets and isn’t assigned to role groups by default in Exchange Online.
In case users report that they can see the wrong GAL/Address Lists, you should check which Address Book Policy is currently assigned to the mailbox:
Get-EXOMailbox -Identity "user@domain.com" `
-Properties AddressBookPolicy |
Select-Object DisplayName, AddressBookPolicy
Troubleshooting Global Address List Issues
When troubleshooting GAL issues, you need to identify the layer where the problem occurs:
- Identity layer (AD/Entra ID)
- Sync layer (Entra Connect)
- Exchange Online directory service
- Outlook cache (OAB/local client)
If Get-AddressList is not recognized, first verify that you are connected to Exchange Online PowerShell and that the Address Lists role is assigned to your account through an appropriate role group. If you have just been assigned the role, you need to disconnect and reconnect to Exchange Online PowerShell so the new session can pick up the updated permissions. Note that role assignment changes may take up to an hour to propagate. If the cmdlet is still unavailable, you need to check the role assignment and the active PowerShell session before troubleshooting further.
or example, you may encounter the following error when running Get-AddressList:
Get-AddressList : The term ‘Get-AddressList’ is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

You should see a list of all the Address Lists in the Microsoft 365 tenant and the recipient filters used.

Once the connection and role assignment are correct, run the following command to list the available address lists and their recipient filters:
Get-GlobalAddressList

Modern Exchange Online troubleshooting (EXO cmdlets)
In Exchange Online, address list and GAL problems are often better diagnosed using recipient-level EXO cmdlets instead of legacy directory queries.
Here are those cmdlets:
- Get-EXORecipient – this one checks how an object is represented in Exchange Online directory
- Get-EXOMailbox – this cmdlet validates mailbox-specific properties (RecipientTypeDetails, HiddenFromAddressListsEnabled, etc.)
- Get-User – checks user-account properties for user objects, including users that do not have mailboxes. Use Get-EXORecipient or the appropriate recipient-specific cmdlet when you need to verify Exchange recipient attributes.
Quick Fixes for GAL not updating issues
- Check HiddenFromAddressListsEnabled, recipient filters, and Address Book Policy assignments using the commands described above.
- If the issue affects classic Outlook for Windows in Cached Exchange Mode, use Send/Receive > Send/Receive Groups > Download Address Book.
- If the recipient is still missing, you need to verify the OAB download and inspect the local cache. Rebuild the cache only if it is stale/corrupted. Investigate BITS jobs only when there is evidence of a failed download.
Rebuild the Offline Address Book cache in classic Outlook
If the recipient is visible in Outlook on the web but is still missing in classic Outlook for Windows running in Cached Exchange Mode, the local Offline Address Book (OAB) cache may be outdated/corrupted.
Before rebuilding the cache, manually download the OAB:
- Open classic Outlook.
- Go to Send/Receive > Send/Receive Groups > Download Address Book.
- Clear Download changes since last Send/Receive to request a full download, then click OK.
If the problem persists, you need to recreate the local OAB cache:
- Close Outlook completely.
- Open File Explorer and enter the following path in the address bar:
%LOCALAPPDATA%\Microsoft\Outlook\Offline Address Books - Open the subfolder corresponding to the affected address book and rename it, for example, by appending .old. If necessary, move the folder to a temporary backup location.
- Start Outlook and download the Offline Address Book again using Send/Receive > Send/Receive Groups > Download Address Book.
Outlook should recreate the local OAB files during the next successful download. If the folder does not exist, or the download fails again, do not proceed with deleting the OST file. You should investigate the OAB download, Autodiscover configuration, and BITS-related errors first.
Important. Note that this procedure applies to classic Outlook for Windows using Cached Exchange Mode. New Outlook does not use the traditional local OAB cache in the same way.
GAL not updating in Outlook client
If downloading the OAB fails in classic Outlook, you should inspect the relevant BITS jobs before taking corrective action. Do not assume that a stuck BITS job is the cause without supporting evidence.
If troubleshooting identifies a specific stuck BITS job associated with the failed OAB download, you need to inspect that job before taking action. Do not remove jobs solely because their display name contains “Outlook”!
Get-BitsTransfer -AllUsers |
Format-List JobId,DisplayName,JobState,OwnerAccount,ErrorDescription
Keep in mind that the -AllUsers switch requires admin privileges. In case you’re troubleshooting your own Outlook profile, you can omit this parameter.
Wrapping up
When troubleshooting GAL issues in Microsoft 365, you need to identify if the problem is caused by recipient visibility settings, address list filters, Address Book Policy assignments, directory sync, or client-side caching.
During recipient visibility troubleshooting, you need to:
- Check that the object exists in Entra ID.
- Check that the object exists in Exchange Online.
- Check HiddenFromAddressListsEnabled.
- Verify Address Book Policy assignments.
- Refresh/rebuild the Offline Address Book.

I have a Comcast email address that I would like to remove from the Public folder …Global address book .
Can you help me ?