> 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/support-us/verifone-hq/device-management/editing-devices/editing-hierarchy.md).

# Editing hierarchy

This section provides an overview of editing hierarchies in VHQ.

{% hint style="info" %}
**Use this when** you need to change a device's hierarchy assignment, configure hierarchy entity settings, or understand select-all behavior on the hierarchy assignment screen.
{% endhint %}

Devices are managed in the hierarchy. You can change a device's hierarchy by editing the hierarchy in **Device Profile**.

## Change a device's hierarchy

{% stepper %}
{% step %}

### Select the device

Select the serial number checkbox for the device in the *Device Search* screen. You can also search for the device if it isn't already visible.
{% endstep %}

{% step %}

### Edit the hierarchy

On the *Actions* window, click **Edit Hierarchy** to change the hierarchy assignment.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/1_6.jpg" alt="Edit Hierarchy action"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set the hierarchy

Set the hierarchy as shown. The hierarchy is updated successfully.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/2.jpg" alt="Setting the hierarchy"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Configure hierarchy entity settings

The hierarchy configuration screen under *Administration* has an option to view and set the **Entity Uid** and **Entity type** for a given hierarchy node.

{% stepper %}
{% step %}

### Open hierarchy configuration

Go to **VHQ** > **Administration** > **Hierarchy**.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/3_0.jpg" alt="Entity Uid and Entity type"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirm the change

Go to the **Device Profile** of the device, then click the expand symbol for more details. The hierarchy is updated successfully.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/4.jpg" alt="Confirming hierarchy update"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Hierarchy assignment select-all behavior

The *Hierarchy Assignment* feature controls the selection of records when using the **select-all** option. It limits the selection to only the records rendered on the current page.

{% stepper %}
{% step %}

### Open Hierarchy Assignment

Go to **VHQ** > **Device Management** > **Manage Reference Sets** > **Hierarchy Assignment**.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/5.jpg" alt="Hierarchy Assignment screen"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select all on the current page

Selecting **Select All** and then navigating to another page displays a warning message.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/6.jpg" alt="Select-all warning message"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Guidelines

* **Yes** clears all selections on the current page and navigates to the next/other page.
* **No** retains the selections on the current page.

<details>

<summary>Keywords</summary>

Also called: edit hierarchy, entity uid, entity type, select all. Search terms: hierarchy assignment, hierarchy configuration.

</details>


---

# 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/support-us/verifone-hq/device-management/editing-devices/editing-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.
