> 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/vhq-parameter-management/configuring-parameter-template-pt-at-hierarchy.md).

# Configuring parameter template (PT) at hierarchy

Assign parameter templates to reference sets at hierarchy levels to apply parameter values across multiple devices under the hierarchy with download automation and inheritance options.

{% hint style="info" %}
**Use this when** you need to apply a parameter template to every device under a hierarchy node, via a reference set.
{% endhint %}

You can assign a reference set to a hierarchy, and VHQ lets you assign parameter templates to that reference set. Reference sets can be inherited or directly assigned at the hierarchy level. All devices under that hierarchy which qualify for the reference set also receive parameter values from the assigned parameter templates (PT).

{% hint style="info" %}
To configure a PT at hierarchy level, you must already have a PT (see Adding parameter template), and it must be assigned to the reference set.
{% endhint %}

## Assign a reference set to a hierarchy

{% stepper %}
{% step %}

### Open Hierarchy Assignment

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

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

{% step %}

### Select the hierarchy node

Select the hierarchy and click the pencil icon. At a hierarchy node, you can assign a parameter template to reference sets directly assigned to that node, and/or to inherited reference sets. Selecting a root hierarchy only offers enabling/disabling download automation; selecting a hierarchy with children also lets you inherit reference sets from the parent (**Yes**/**No**) and enable/disable download automation.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/2_11.jpg" alt="Hierarchy node options"><figcaption></figcaption></figure>

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/3_5.jpg" alt="Hierarchy node inheritance options"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set the download schedule

Enable or disable automatic downloads for the selected hierarchy with the **Download Automation** checkbox, then choose a schedule:

* **Next contact**: Schedule the download for the device's next heartbeat.
* **Next Available free time slot**: The VHQ server identifies the next free time slot for the download.
* **Maintenance window**: Schedule the download during the device's next maintenance window.
* **Download during maintenance window**: Only download during the maintenance window's free time slot.
  {% endstep %}

{% step %}

### Assign reference sets

The *Reference sets* tab lists reference sets available from the hierarchy. Assign multiple reference sets to a hierarchy node and order them to determine which one qualifies for devices under that path. The *Parameter templates* tab activates once a reference set is selected — changes to the template's parameter values apply to all applicable devices under the hierarchy and its children.

Click **Expand** to view details of the qualified reference sets.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/4_2.jpg" alt="Qualified reference sets"><figcaption></figcaption></figure>

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/5_2.jpg" alt="Reference set details"><figcaption></figcaption></figure>

Click **Save** to assign the reference set to the hierarchy.
{% endstep %}

{% step %}

### Assign parameter templates

The *Parameter Templates* tab lists all templates available to the reference sets assigned to the hierarchy. Select the template(s) to assign to devices under the hierarchy.

A popup confirms how many devices will be affected.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/6_1.jpg" alt="Devices affected confirmation"><figcaption></figcaption></figure>

Click **OK**, then **Save**. Multiple hierarchy templates can be assigned to one node — since parameter templates are mutually exclusive, no ordering is needed. VHQ validates that an assigned template doesn't conflict with any hierarchy template values assigned above (if inherited) or below (if passed down). This validation only runs when **Inherit from Parent Hierarchy** is enabled.

If a conflict is found, VHQ shows: *One or more of the parameters in the template(s) you are assigning conflicts with parameter that is already assigned. For duplicate parameters, click here* — from which you can view the conflicting parameters and instances.

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/7.jpg" alt="Conflicting parameters"><figcaption></figcaption></figure>

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/8.jpg" alt="Conflict detail"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Guidelines

* You can add, edit, delete, copy, and view a parameter template for an application from the *Application Library* screen.
* The *Parameter Template for Application* screen (under **Manage Downloads** > **Application Library** > **Configure**) includes a **Hierarchy Name(s)** column, listing any hierarchies the template is assigned to (comma-separated).

<figure><img src="https://verifone.cloud/sites/default/files/inline-images/9.jpg" alt="Hierarchy Name(s) column"><figcaption></figcaption></figure>

* Only regular (non-hierarchy) templates can be deleted. A hierarchy template must first be unassigned from the hierarchy level before it can be deleted.

{% hint style="info" %}
Unassigning a template from a hierarchy's reference set restores default parameter values on affected devices. You can't overwrite parameter files, VPDX, or VPFX files while a parameter template is assigned to the hierarchy — and you can't delete a reference set while a PT is assigned to it.
{% endhint %}

<details>

<summary>Keywords</summary>

Also called: hierarchy parameter template, PT at hierarchy. Search terms: hierarchy assignment, reference set conflict.

</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/vhq-parameter-management/configuring-parameter-template-pt-at-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.
