Last date modified: 2026-Mar-02
Blocklisting
The Blocklist is a list of excluded PI Values. You can use Blocklisting to identify personal information (PI) that is not relevant for review or was falsely tagged, and add them to the Blocklist to prevent it from being identified again. Adding a term to the Blocklist removes all annotations for that term across the document set, any links associated with those annotations and all references to that term on the entity report. 
With Blocklisting you can:
- See a list of all terms detected PI from unstructured documents
- Select one or more terms and add them to the Blocklist
- Access documents a term appears on to validate if it should be blocklisted
- View all terms on the Blocklist and remove them from the Blocklist
- View PI values from structured documents that have been ignored
Requirements
Blocklisting is only available for users with the Data Breach Response - Lead permission.
For more information on permissions, see User roles and permissions.
Blocklisting
The Blocklisting tab shows all terms that have been identified as PI in unstructured documents. From here, you can add these terms to the Blocklist. You can also view terms that have been added to the Blocklist and remove them from the Blocklist.

The Blocklisting table has the following columns:
| Column | Description |
|---|---|
|
PI Value |
The value that was identified as PI |
|
PI Type |
The PI Type the value is currently assigned |
|
Total Count |
The total count of the PI value across all documents |
|
Document Count |
The count of documents the PI value appears o |
|
Blocklisted |
Whether or not the PI value has been added to the Blocklist. There are two possible values:
|
|
Blocklisted By |
If the value is on the Blocklist, this column will contain the name of the user who completed the action |
|
Blocklisted On |
If the value is on the Blocklist, this column will contain the timestamp of when the action was completed. The timestamp format will reflect the date format configured in your browser settings. |
Excluded Cell Values
The Excluded Cell Values tab shows cell values from structured documents where the column was identified to contain PI, but the cell value shown does not match the expected pattern associated with the PI type of the column itself. Therefore, these values are not being identified as PI and won’t be linked to an entity or appear on the entity report.
The Excluded Cell Values table has the following columns:
| Column | Description |
|---|---|
|
PI Value |
The value of the cell being excluded |
|
PI Type |
The PI type assigned to the column that contains the excluded cell value |
|
PI Count |
The total count of the PI value across structured documents |
|
Total Documents |
The count of documents the PI value appears on |
Reviewing and Blocklisting terms
Reviewing and blocklisting terms is a key step in refining your PI detection results and ensuring that your analysis focuses on the information that matters. This stage allows you to evaluate detected PI values, prioritize those with the greatest impact, and curate a Blocklist that improves accuracy across your project. By filtering high‑volume detections, examining priority PI types, and managing both additions to and removals from the Blocklist, you maintain control over how PI is interpreted and annotated. Because updates only take effect after rerunning the Blocklisting and Compile Insights stages, this process becomes an essential, iterative part of maintaining clean, reliable data throughout your review.
Suggested Blocklisting workflow
To get the highest return from Blocklisting, review terms in the Blocklisting tab after selecting your PI detectors, after running Data Analysis for the first time, and prior to review. These workflows can also be executed during the review process.
Following is the suggested method of prioritizing terms for review:
- On the Blocklisting tab, filter the table so items with the highest PI count are at the top. This ensures that the PI values you review and add to the Blocklist have the greatest impact across the entire dataset.
- Focus on high-priority PI types and analyze their results by filtering the table for the specific PI type.
- Once you have finished Blocklisting PI values, rerun the Blocklisting and Compile Insights stages of Data Analysis. This will update the PI annotations on the documents and PI counts on the Project Dashboard and Blocklisting tabs.
Blocklisting PI values
If you identify a term that you want to add to the Blocklist:
- Select the checkbox next to the PI value. You can select multiple values at a time to add to the Blocklist.
- Select the Add to Blocklist mass action.
- A modal will appear, click Continue to confirm.

- Once the value is added to the Blocklist, the Blocklisted column will update to Yes, and the Blocklisted By and Blocklisted On columns will update with the name of the user who completed the action as well as the date.

- Once the value is added to the Blocklist, the Blocklisted column will update to Yes, and the Blocklisted By and Blocklisted On columns will update with the name of the user who completed the action as well as the date.
- Once you have finished Blocklisting PI values, rerun the Blocklisting and Compile Insights stages of Data Analysis.
This will update the PI annotations on the documents and PI counts on the Project Dashboard and Blocklisting tabs.
Removing PI values from the Blocklist
PI values that are currently on the Blocklist will have a value of Yes in the Blocklisted column.
Remove PI values from the Blocklist by:
- Select the checkbox next to the PI value. You can select multiple values at a time to remove from the Blocklist.
- Select the Remove from Blocklist mass action.
- A modal will appear, click Continue to confirm.

- Once the value is removed from the Blocklist, the Blocklisted column will update to No.

- Once the value is removed from the Blocklist, the Blocklisted column will update to No.
- After you remove PI values from the Blocklist, rerun the Blocklisting and Compile Insights stages of Data Analysis. This will update the PI annotations on the documents and PI counts on the Project Dashboard and Blocklisting tabs.
Viewing Excluded PI values from structured documents
During PI detection in structured documents, Data Breach Response identifies table columns that contain PI. In addition, individual cell values are analyzed to confirm that they contain the PI that the header indicates is contained in the column.
For example, if a column is named Passport Number, we check the contents of the column to confirm it actually matches the format of a Passport Number.
It’s possible that a single cell value will not match the format of the data in the rest of the column. In that case, Data Breach Response will not identify the value in the cell as PI and surface it in the Excluded Cell Values sub-tab for transparency.
Overriding excluded PI Values
For values that have been excluded for the reasons above, you can choose to override this decision so they are included as PI using the Include mass action.
To override Excluded PI values:
- Select the checkbox next to the value. You can select multiple values at a time.
- Select the Include mass action. A modal will appear, click Continue to confirm.
- The value will disappear from the list when the action is complete.
- Once you have finished, rerun the Blocklisting and Compile Insights stages of Data Analysis. This will update the PI annotations on the documents and PI counts on the Project Dashboard and Blocklisting tab.
Considerations
Keep the following considerations in mind when using Blocklisting.
- Once you have added or removed PI values from the Blocklist, PI annotations on the documents and the PI counts on the Project Dashboard and Blocklisting tabs will not be updated until Data Analysis is run.
To update these, rerun the Blocklisting and Compile Insights stages Data Analysis. - Only PI values from unstructured documents appear on the Blocklisting tab. However, if a value that you add to the Blocklist also appears on a structured document, the annotation in the structured document will also be removed.
- When there are greater than one million unique PI detections from unstructured documents, the Blocklisting tab may take longer to load when opening the tab.