# How to block a phone number in VICIdial, inbound and DNC

> Block a caller in VICIdial from the live floor: one right-click puts the number on an inbound filter list and on the internal DNC list. Five steps, with undo.

URL: https://trustane.com/guides/vicidial-block-caller-inbound
By Trustane. Published 2026-11-14, updated 2026-11-19.

> **To the point**
> To block a phone number in VICIdial you need two lists: one that stops the number **calling in**, and one that stops your campaigns **dialing it**. In the Trustane console that is one right-click:
>
> 1. On the **Floor**, right-click the caller and pick **Block this caller**.
> 2. Read what the dialog shows before anything is written: the list, and what happens to its calls in.
> 3. Press **Block**.
> 4. See it, and undo it, under **Numbers › Blocked callers**.
> 5. Tick **Agents can block callers** if agents should do it themselves.

Video: [How to block a caller in VICIdial from the live floor](https://www.youtube.com/watch?v=zNcfFQba1IE)

The pictures come from our demo account. Its phone numbers are made up.

## Why one block needs two lists

VICIdial keeps inbound and outbound apart. A **filter phone group** is a list of caller numbers that a line checks when a call comes in. The **internal DNC list** is what the dialer checks before it dials. Neither list reads the other, so a number on only one of them is half blocked. [How the inbound filter works](https://trustane.com/blog/vicidial-filter-phone-groups) has the detail.

## 1. Right-click the caller on the Floor

The Floor lists the callers waiting in your queues. Right-click a number and pick **Block this caller**.

![The Floor's Calls waiting panel with the right-click menu open on 12065550171: Open the caller, Who can take it, Block this caller](https://trustane.com/media/f3848521d69cb978-1488x700.webp "Right-click a waiting caller")

The same choice is on the caller's own record, and on an agent's menu when the inbound number they are on has rung the floor several times today.

## 2. Read what it will do

Nothing is written yet. The dialog shows what the block will do:

1. **List**: the server's block list. You can pick another caller list here.
2. **Calls in**: hung up, on the lines that check that list.

![The Block dialog for 12065550171, 1 call today: List, then Calls in: Hung up, all lines](https://trustane.com/media/6b47e432fb2313b2-559x368.webp "What the block will do, before it does it")

The block also puts the number on VICIdial's internal DNC list. What that list stops depends on the campaign. VICIdial skips a number on it when it auto-dials, as long as the campaign's **Use Internal DNC List** is Y (the default) or AREACODE. A manual dial is checked only if the campaign's **Manual Dial Filter** includes DNC, and that setting ships as NONE.

## 3. Press Block

One press does all of this. The numbers go in through VICIdial's own API, and the lines are set directly on the server:

1. The number goes on the block list **twice**, with and without the leading 1. The inbound filter matches the number exactly, so 2065550171 and 12065550171 are two entries.
2. Both forms go on the internal DNC list.
3. On the first block, every active line that has no caller filter is set to check the block list and to send a match to extension 8300, which hangs up in VICIdial's default dialplan.

The confirmation says how far it reached: "12065550171 is blocked and on the do-not-call list. 1 of 1 lines turn it away."

A line that already has a caller filter of its own keeps its own action: the block list is added to what that line checks, and the confirmation counts those lines apart.

## 4. See it, and undo it

**Numbers › Blocked callers** lists every blocked number, the day it was added, and under **Turned away** how many of its calls a caller filter caught in the last 90 days.

![Numbers, Blocked callers: the block list Blocked callers (BLOCKED), 1/1 lines hang up, and one blocked number, 1 206 555-0171, with Unblock](https://trustane.com/media/22427bef68d5a158-1600x420.webp "Every blocked number, with its Unblock")

**Unblock** takes the number off the block list, in both forms. Its next call is answered again. It stays on the internal do-not-call list; take it off under Campaigns, Do not call, only if it never asked not to be called.

To block many numbers at once, press **Block numbers** and paste them in.

## 5. Let agents block a caller

Tick **Agents can block callers** on the same page.

![The Blocked callers band with Agents can block callers ticked: Block caller, then BLOCKED plus do-not-call](https://trustane.com/media/cc349ce12e25e286-1600x174.webp "The agents' own block, switched on")

That adds one status, **Block caller**, to the server's own status table, so it shows as a disposition on our agent screen and on VICIdial's agent screen alike. VICIdial builds an agent's disposition list when they log in, so agents see it after their next login.

When an agent on our screen picks it, the caller is blocked as the disposition is taken. A block taken on VICIdial's own agent screen is picked up by a sweep, and the page shows how many are waiting for it.

## The same block by hand, in VICIdial's admin

If you run VICIdial without our console, these are the screens:

1. **Inbound → Add Filter Phone Group**: give it an ID and a name.
2. **Inbound → Add FPG Number**: pick the group and enter both forms of the number, one per line.
3. **Inbound → Show DIDs →** the DID: set **Filter Inbound Number** to GROUP, pick the **Filter Phone Group ID**, set **Filter Action** to EXTEN and **Filter Extension** to 8300.
4. **Lists → Add DNC Number**: add both forms to the internal list.
5. Repeat step 3 for every other DID that should turn the caller away.

## What a block does not do

- It is your server's own list. It is not a national registry and it scrubs nothing against one.
- It does not change what a line with its own filter does with a match.
- If a DID uses VICIdial's **Clean CID Number** setting, the number is rewritten before the filter sees it, so check which form that DID compares.

## Next steps

- [VICIdial DNC lists, explained](https://trustane.com/blog/vicidial-dnc-lists): the internal list, campaign lists and how a number gets on them.
- [Assign in-groups to agents from the floor](https://trustane.com/guides/vicidial-assign-in-groups-to-agents).
- [Start a server](https://trustane.com/order), free for 7 days.

VICIdial is a trademark of its owner. Trustane is an independent hosting provider.
