> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/verifone-central-getting-started/verifone-central/verifone-central-device-manager/tenants.md).

# Tenants

Use **Tenants** to separate devices, users, and visibility by customer or operational boundary.

Tenant access helps control who can view, manage, and support each part of the estate.

Use this page to confirm tenant scope before you create, change, or remove a record.

### Before you start

Confirm that:

* your role allows you to view or manage tenants
* you are working in the correct estate or customer context
* you know whether you need to add, review, edit, or delete a tenant

Prepare these details when available:

* tenant name
* customer or reseller context
* any devices or users that must belong to the tenant

{% hint style="info" %}
Tenant operations can depend on your assigned access scope and licensed features. Tenant management is available in both the UI and API.
{% endhint %}

### Choose the tenant task

* **Create a boundary** — [add a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/add-a-tenant).
* **Check ownership or details** — [view a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/view-a-tenant).
* **Change or remove a record** — [edit](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/edit-a-tenant) or [delete](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/delete-a-tenant) the tenant.

Before deletion, confirm that users and devices no longer depend on the tenant.

### What tenants control

Use tenants to:

* separate device portfolios by merchant, reseller, or business unit
* limit visibility so users see only the devices and operations they are allowed to access
* support tenant-specific device management and diagnostic workflows

### Who can manage tenants

These are the main tenant access levels:

* **Estate Owner Admin** and **Verifone Admin** — add, edit, delete, and view tenants
* **Verifone Helpdesk** — view and edit tenants
* **Merchant Admin** and **Merchant User** — view tenants only

{% hint style="info" %}
Actual visibility can also depend on the tenant, hierarchy, or group assigned to the user. For broader access details, see [User roles and permissions](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/user-roles-and-permissions).
{% endhint %}

### Open tenants

Go to **Verifone Central** → **Device Management** → **Tenants**.

### Tenant workflow

Tenant work usually follows this flow:

1. Create a tenant.
2. Review the tenant details.
3. Update the tenant when ownership or setup changes.
4. Delete the tenant when it is no longer needed.

Use:

* [Add a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/add-a-tenant)
* [View a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/view-a-tenant)
* [Edit a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/edit-a-tenant)

### How tenants affect device management

When tenant access is configured correctly, users can:

* work only with the devices available to their tenant scope
* switch context when they are allowed to support multiple customers
* move or remove devices across tenant boundaries when their role and license permit it

### Result

Tenants help you organize the estate, control visibility, and route device management work to the right users. Verify the record in the correct customer context after every change.

### Next steps

* [Add a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/add-a-tenant)
* [Edit a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/edit-a-tenant)
* [Delete a tenant](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/tenants/delete-a-tenant)
* [User roles and permissions](https://verifone.gitbook.io/us-core-help-center/verifone-central/verifone-central/user-roles-and-permissions)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verifone.com/verifone-central-getting-started/verifone-central/verifone-central-device-manager/tenants.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.