> 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-device-management/verifone-central/devices/manage-hierarchies-and-groups/add-a-root-hierarchy.md).

# Add a root hierarchy

Use **Root Node** to add a hierarchy directly under the root level.

### Before you start

Prepare:

* the new hierarchy **Name**
* the new hierarchy **Entity Type**
* confirmation that the node belongs at the top level

Use this action only when the new hierarchy should not sit under an existing parent node.

### Add a root hierarchy

{% stepper %}
{% step %}

### 1. Open Hierarchies

Go to **Verifone Central** → **Device Management** → **Hierarchy/Group Management** → **Hierarchies**.
{% endstep %}

{% step %}

### 2. Open the root node action

Select **Actions** → **Update Hierarchy** → **Root Node**.
{% endstep %}

{% step %}

### 3. Enter the new hierarchy details

Enter the required values for the new top-level node.
{% endstep %}

{% step %}

### 4. Save the new node

Save the hierarchy and return to the tree.
{% endstep %}
{% endstepper %}

<div data-with-frame="true"><figure><img src="/files/d1qyF7m3QhMPS0386DcU" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/E8t6Fpm1rrUWkIlw3sbU" alt=""><figcaption></figcaption></figure></div>

### Required values

New root hierarchies require at least:

* **Name**
* **Entity Type**

Use a name that clearly distinguishes the root node from existing branches.

### Verify the result

After you save, confirm that:

* the new node appears at the root level
* the name and entity type are correct
* the new hierarchy is ready for child nodes, users, or device placement

### Common checks

If the node appears in the wrong place, check these first:

* the new hierarchy should have been added as a child node instead
* the entered values do not clearly identify the new top-level branch
* the action was opened from the wrong path

### Result

The new hierarchy is added at the root level.

### Next steps

* [Add a child hierarchy](/verifone-central-device-management/verifone-central/devices/manage-hierarchies-and-groups/add-a-child-hierarchy.md) — build the next level under the new root
* [Edit a hierarchy](/verifone-central-device-management/verifone-central/devices/manage-hierarchies-and-groups/edit-a-hierarchy.md) — update the node details if needed


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/verifone-central-device-management/verifone-central/devices/manage-hierarchies-and-groups/add-a-root-hierarchy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.