# Blacklist

`Targeting > Blacklist Upload`

Upload, view, and manage your blacklisted users. In addition to general contact uploads, you can manage **channel-based blacklists and whitelists** from this flow.

* Add users to a blacklist for one or more channels.
* Remove users from a blacklist (whitelist) for one or more channels.
* Track each upload with list name, date, status, and channels.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FHFT6yX6rekP0V2Cn2GRR%2FGroup%2091598.png?alt=media&#x26;token=e1daad72-3302-4666-ada3-f76adf34a305" alt="" width="563"><figcaption></figcaption></figure>

#### Channel-based management

You can select one or more channels during the upload. Changes apply only to selected channels. Available channels depend on your enabled products. Options include:

* **Mobile** (Mobile Push), **Web** (Web Push), **SMS, Email, WhatsApp**

### Blacklist Dashboard

The dashboard lists your previous uploads. Each row represents one uploaded list.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FIajq2zjn4nSbY8dVmKLF%2FScreenshot%202025-12-19%20at%2009.44.23.png?alt=media&#x26;token=fb1b7ca3-4d21-4ce7-97e8-952d8b21fc3d" alt=""><figcaption></figcaption></figure>

You can review:

* **List Name**
* **Upload Date**
* **User Count**
* **Status** (for example, *Waiting for Approval* or *Ready*)
* **Channels** affected by the upload
* **Actions** (view or edit depending on status)

### Blacklist Upload

Use this step to add users to the blacklist.

Blacklisted users won’t receive messages on the selected channels.

1. Set a **List Name**.
2. (Optional) Set a **Tag Name**.
3. Upload your `.csv` or `.txt` file.
4. Select the channels you want to blacklist.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FdOqLjNKas1pyrUilvAX9%2FScreenshot%202025-12-19%20at%2009.23.33.png?alt=media&#x26;token=c29c0dde-d0f4-4296-a289-1d76c2f7b330" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### File format and identifiers

* Format: **CSV** or **TXT**
* Each row should represent **one user**
* Use a valid header name:

  `Email`, `Mail`, `Phone Number`, `Phone`, `ExId`, `Device Token`, or `Token`
  {% endhint %}

5. Review the preview.
6. Click **Approve** to submit the upload.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FJgSKJYTuE5DH8bB5TIF3%2FScreenshot%202025-12-19%20at%2010.11.58.png?alt=media&#x26;token=0560e396-1a5a-4952-aea2-5b91dc258fc4" alt=""><figcaption></figcaption></figure>

{% file src="<https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F7YTrqGpMX8KYndAce7ZE%2FSample%20Blacklist%20File.txt?alt=media&token=00f9d093-0d64-4687-96b7-e5d606c6c9ed>" %}

#### Invalid Header Name&#x20;

If the first row (header) does not use one of the allowed identifier names, the system cannot map the file correctly. In the **Preview** tab, the column with an invalid header (for example `Phone Namber` instead of `Phone Number` ) is highlighted.

The summary at the bottom shows:

*“7 columns will be imported, 1 column will not be imported. 0 contacts will be uploaded.”*

Because there is no valid identifier column, the upload cannot be approved and the system shows the  error:

**How to fix**

1\. Use a valid header name

Replace the first row with one allowed identifier column:

**`Email`, `Mail`, `Phone Number`, `Phone`, `ExId`, `Device Token`, or `Token`**

2\. Remove extra separators

3\. Ensure each row has exactly one value

4\. Clean hidden characters

### Whitelist Upload

`Targeting > Whitelist Upload`

Use this step to remove users from the blacklist.

This makes them eligible again on the selected channels.

1. Set a **List Name**.
2. (Optional) Set a **Tag Name**.
3. Upload your `.csv` or `.txt` file.
4. Select the channels you want to whitelist.
5. Review the preview.
6. Click **Approve** to submit the upload.

Whitelisting does not bypass consent rules.

Users still need valid permission per channel.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FV7fZWuv1eBiEvHkFrFR4%2FScreenshot%202025-12-19%20at%2009.53.45.png?alt=media&#x26;token=98db8b30-ab60-46ca-b2d0-c4db8310c921" alt=""><figcaption></figcaption></figure>

### Blacklist vs whitelist priority

For each end user, Netmera keeps a history of **blacklist** and **whitelist** records by channel. If a user has both types of records:

* The **most recent record wins**.
* If a newer **whitelist** record exists after a blacklist record, the user is treated as **whitelisted** (eligible) on that channel.

This ensures that changes made through your latest uploads are always respected and traceable.

### View user status in People

`Targeting > People > User Details`

In **User Details**, you can see the user’s blacklist/whitelist status **per channel**. The information is shown in a clear, readable list.

If the user is **not** blacklisted on a channel, no record is shown for that channel.

If the user is blacklisted on a channel, a record is shown in this format:

* Added to Mobile blacklist via “listName” on "date".
* Added to Web blacklist via “listName” on "date".
* Added to SMS blacklist via “listName” on "date".
* Added to Email blacklist via “listName” on "date".
* Added to WhatsApp blacklist via “listName” on "date".

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FWuqsAa1kqTkchWxXUu52%2FScreenshot%202025-12-19%20at%2009.51.05.png?alt=media&#x26;token=a8f89af8-92dc-4f8b-b99f-3af0cadebd9b" alt=""><figcaption></figcaption></figure>
