> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/email/reports/global-address-list.md).

# Global Address List

This report lists every recipient in the selected tenant's Global Address List, covering mailboxes, shared mailboxes, resources, mail contacts, and mail enabled groups. Its main use is checking what is and is not visible in the address book, and hiding or unhiding entries without going near Exchange Online PowerShell.

## Filters

Preset filters are available from the **Filters** button:

| Filter               | Shows                                                                   |
| -------------------- | ----------------------------------------------------------------------- |
| Hidden from GAL      | Recipients that are hidden from the address list.                       |
| Shown in GAL         | Recipients that appear in the address list.                             |
| Cloud only mailboxes | Recipients that are not synchronised from on-premises Active Directory. |

## Table Details

The properties returned are for the Exchange Online PowerShell command `Get-Recipient`. For more information on the command please see the [Microsoft documentation](https://learn.microsoft.com/powershell/module/exchangepowershell/get-recipient).

## Table Actions

<table><thead><tr><th>Action</th><th>Description</th><th data-type="checkbox">Bulk Action Available</th></tr></thead><tbody><tr><td>Unhide from Global Address List</td><td>Puts the entry back in the address book so people can find it when composing mail. Greyed out where the entry is already visible.</td><td>true</td></tr><tr><td>Hide from Global Address List</td><td>Takes the entry out of the address book. Mail addressed to it directly still arrives. Greyed out where the entry is already hidden.</td><td>true</td></tr><tr><td>More Info</td><td>Opens the Extended Info flyout with the full details for the selected row.</td><td>false</td></tr></tbody></table>

Both actions confirm first, and both apply to mailbox backed recipients only. Running them against a mail contact or a mail enabled group returns an error.

{% hint style="warning" %}
Where **Is Dir Synced** is `Yes`, the entry is owned by on-premises Active Directory. Make the change on the on-premises object instead, or directory synchronisation will put the old value back.
{% endhint %}

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/email/reports/global-address-list.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.