Customers

A 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.

---

From the sidebar, navigate to Customers. The Customers page lists all Customers and 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 + 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 customer to open its details.
3. Click the orange pencil icon (Edit) to enter edit mode.
4. Update the customer information.
5. Click Apply changes.

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

---

Customer users are individual user accounts granted access to the platform within the scope of a specific Customer. Unlike a Tenant, a Customer doesn’t own resources outright — it’s granted scoped access to a subset of the Tenant’s resources, so a Customer user can only interact with entities specifically assigned to their Customer account.

For details on creating and managing Customer users, see Users.

---

Each row in the Customers table includes actions for managing that customer’s 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. The following tabs provide access to all configuration, monitoring, and management tools for the selected Customer.

Tab name	Description
Details	Edit core Customer information, access management shortcuts (users, assets, devices, dashboards, etc.), and copy 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 (subject to Tenant-level 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