Customers

Customer in ThingsBoard is a logical business entity (for example, a department, company branch, or external client) used to isolate data and provide controlled access to IoT resources within a Tenant.

Customers allow a Tenant to delegate access to devices, assets, dashboards, and other entities while maintaining clear ownership boundaries and enforcing permissions using the ThingsBoard RBAC model.

---

1. Open the ThingsBoard UI.
2. Navigate to Entities ⇾ Customers.

The Customers page displays all Customers available provides tools to add and manage them.

---

Tenant Administrators can create, edit, and delete Customers, as well as manage their assigned resources.

1. From the sidebar, navigate to Customers.
2. Click the + Add customer in the top right corner.
3. Enter a title.
4. Optionally, specify the address, phone number, and contact email.
5. Click Add.

New customers appear in the customer list, where actions for managing their resources are available.

1. From the sidebar, navigate to Customers.
2. Click the target customer to open details.
3. Click the orange pencil icon (Edit) to enter edit mode.
4. Update the customer information.
5. Apply changes.

1. Click the trash icon next to the customer name.
2. Confirm deletion.

---

Customer users are individual user accounts granted access to the platform within the scope of a specific Customer.

To learn how to create and manage Customer users, refer to the corresponding section in this documentation.

---

In the Customers table, each Customer provides a set of actions that allow you to manage the associated customer resources.

Icon	Description
Manage customer users	View, create, edit, activate, deactivate, and delete users associated with the Customer.
Manage customer assets	Add, manage, and delete customer assets.
Manage customer devices	Add, manage, and delete customer devices.
Manage customer edges	Add and manage Edge instances associated with the Customer.
Manage customer dashboards	Add, view, manage, and delete Dashboards available to the Customer.
Delete	Remove the Customer and its associated users from the system.

---

Clicking a Customer in the Customers table opens the Customer details page.
This page provides centralized access to configuration, monitoring, and management tools for the selected Customer. The tabs below allow you to manage Customer settings, data, alarms, relations, and system activity within a single interface.

Tab name	Description
Details	Allows editing of core Customer information, provides quick access to related management actions (users, assets, devices, dashboards, etc.) and allows copying the Customer ID.
Attributes	Manage Customer attributes.
Latest telemetry	View and manage the most recent telemetry values associated with the Customer. Supports adding new telemetry entries and deleting existing data.
Alarm rules	Configure alarm rules at the Customer level to define conditions that trigger alarms based on telemetry or attribute data (inherited or permitted by Tenant configuration).
Alarms	View and manage alarms related to the Customer, including acknowledgment and status updates.
Events	View system events associated with the Customer, including lifecycle events, warnings, and errors for troubleshooting and monitoring.
Relations	Manage entity relationships between the Customer and other entities such as devices, assets, dashboards, or rule chains. Allows creating and deleting relations.
Audit logs	View a history of actions performed on the Customer entity, including configuration changes and user activities.
Version control	Manage versioned exports and restore operations for Customer-related entities using the version control service .

---

Capability	Description	Guide
Create customer users	Add user accounts for customer staff so they can log in and access only their own entities and dashboards	Users
Assign devices and assets	Link devices, assets, and dashboards to a customer to scope their visibility to that customer’s users only	Devices
Build customer dashboards	Create dashboards visible to customer users that display only their own entities’ data	Dashboards
Define access permissions	Control which entities and actions customer users can access using role-based access control	Roles
Organize with entity groups PE / Cloud only	Group a customer’s entities by type or purpose for bulk management and fine-grained permission assignment	Entity Groups
Create sub-customers	Build a multi-level customer hierarchy for reseller or delegated management scenarios	Customers
Enrich rule chain messages	Reference customer-level attributes in rule chains to route or enrich messages based on customer context	Rule Engine