> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenoo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# How Do I Manage Entities?
> Navigate the UBO tree, view entity verification status, add new entities to a case, and manage cross-case entity history.
# How Do I Manage Entities?
Entities are the people and companies linked to a case. A company onboarding case might have a dozen entities — the company itself, its directors, UBOs, and shareholders. This guide explains how to navigate, manage, and track verification status for all of them.
## What you'll learn
* How to read the entity panel and UBO tree
* What each entity role means for required checks
* How to view an entity's verification status
* How person cases work for individual entities
* How cross-case entity history works
## The entity panel
When you open a case, the entity panel shows all linked entities in two views:
The tree view shows the ownership and control structure:
* **Root node** — the primary entity (company)
* **Branch nodes** — directors, UBOs, and shareholders, connected by lines showing their relationship
* **Ownership percentages** — displayed next to UBO nodes
* **Status indicators** — colored dots showing each entity's verification status
Click any node to expand its detail panel showing checks, documents, and alerts.
The list view shows all entities in a flat table:
* **Name** — entity name
* **Role** — Primary, UBO, Director, Shareholder
* **Type** — Company or Individual
* **Verification Status** — Pending, In Progress, Verified, Failed
* **Risk Rating** — High, Medium, Low
* **Ownership %** — for UBOs and shareholders
* **EDD Required** — whether Enhanced Due Diligence is flagged
Click any row to see that entity's checks, documents, and alerts.
## What does each entity role require?
The entity's role determines which checks are automatically created:
| Check | Primary (Company) | UBO | Director | Shareholder |
| ----------------------- | ----------------- | ------------ | ------------ | ----------- |
| PEP/Sanctions Screening | Required | Required | Required | Required |
| Adverse Media | Required | Required | Required | -- |
| Identity Verification | -- | Required | Required | Required |
| Address Verification | -- | Required | -- | -- |
| Source of Wealth | -- | If High Risk | If High Risk | -- |
If a UBO or director is flagged as high risk during screening, additional checks (Source of Wealth, Enhanced Due Diligence) are automatically added to their requirements.
## How do I view an entity's verification status?
Click an entity in the tree or list view to open its detail panel. The panel shows:
* **Overall status** — a summary badge: Pending (grey), In Progress (blue), Verified (green), Failed (red), Expired (orange)
* **Check progress** — a breakdown of each check type with its current status
* **Document progress** — which documents have been received and which are still outstanding
* **Alerts** — any open alerts related to this specific entity
The overall status is calculated automatically:
* **Verified** — all required checks are Complete with a Pass result
* **Failed** — any required check has a Fail result that has not been resolved
* **In Progress** — at least one check is running or pending
* **Expired** — a previously verified entity whose checks have passed their validity period
## What are person cases?
When a company case includes individual entities (UBOs, directors, shareholders), the system automatically creates **person cases** for each one. Person cases:
* Track the individual's verification independently
* Can be shared across multiple company cases (if the same person appears in multiple companies)
* Are linked back to the company case via a relationship field
This means if John Smith is a director at two companies, he has one person case with his identity verification and screening — shared by both company cases.
## How does cross-case entity history work?
Zenoo tracks verification at the entity level, not just the case level. This means:
* **Reused checks** — if an entity was verified recently (within the validity period), new cases can reuse those check results instead of running them again. Reused checks show a "Reused" badge with the source case name.
* **Entity-level status** — each Account and Contact in Salesforce has an overall verification status that reflects their latest checks across all cases.
* **Verification history** — click "View History" on an entity to see all past checks across all cases, with dates, results, and validity periods.
Check reuse saves time and provider costs. A recently verified UBO joining a new company case will have their identity and screening checks automatically reused if they are still within the validity window.
## What's next?
Manage check requirements, trigger re-runs, and waive checks.
See how entity risk factors feed into the overall case risk.
Investigate alerts generated by entity checks.
Close the case once all entities are verified.