> ## Documentation Index
> Fetch the complete documentation index at: https://portaldocs.peartelco.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Number Blocking

> Block unwanted callers so their calls never reach your phone system

<Frame>
  <img src="https://mintcdn.com/pearaustralia/Em-4hkAq2x1gGY0F/images/number-blocking-page.png?fit=max&auto=format&n=Em-4hkAq2x1gGY0F&q=85&s=4dcdc78b1889f01905723ac4deba66bf" alt="Number Blocking page" width="1280" height="900" data-path="images/number-blocking-page.png" />
</Frame>

## Overview

Number Blocking lets you stop specific phone numbers from calling your business. When a blocked number calls in, the call is rejected before it reaches any extension or queue. Use this to stop persistent spam callers, telemarketers, or any number you never want to hear from again.

## How to block a number

1. Go to **Number Blocking** in the left menu.
2. In the **Add Number to Block** section, enter the phone number in the **Phone Number** field.
3. Optionally add a note in the **Description** field, e.g. *Spam caller* or *Wrong number*.
4. Click **Add to Block List**.

The number will appear in the **Blocked Numbers** list immediately.

<Note>
  Enter the number exactly as it appears in your Caller ID, including the area code. For example: `0412345678` or `0288663000`.
</Note>

## Blocked numbers list

All currently blocked numbers are shown in the table below the form, with:

| Column           | What it shows                                  |
| ---------------- | ---------------------------------------------- |
| **Phone Number** | The blocked number                             |
| **Description**  | The note you added when blocking (if any)      |
| **Added By**     | Which user added this number to the block list |
| **Date Added**   | When the number was blocked                    |

## Editing or removing a blocked number

* Click the **pencil icon** on any row to update the description.
* Click the **trash icon** to remove the number from the block list. The number will be able to call in again immediately.

## Frequently asked questions

**Does blocking a number affect all extensions?**

Yes. A blocked number is rejected at the system level before it reaches any extension, queue, or voicemail on your site.

**Can I block a range of numbers?**

No. Numbers must be added one at a time and each must be an exact match. If you need to block a large range of numbers, log a support call with Pear.

**What does the caller hear when they're blocked?**

The call is rejected. The caller will typically hear a busy tone or a "number unavailable" message depending on their carrier.

**Can I see a history of calls from a blocked number?**

Blocked calls may still appear in [Call History](/reporting/call-history) depending on how early in the call flow the block is applied.