# Add purpose to configuration tree

{% hint style="success" %}
**Access Type:** Configuration Tree - Editor

**Premium Feature**: Preference Management Platform
{% endhint %}

A purpose describes the reason your organization is collecting the end-user's preference data within your PMP configuration tree. In this article, we will cover how to add a purpose to your PMP configuration tree so that you can subsequently map a preference(s) to it . 

Click **Preferences** on the left-hand panel.

<figure><img src="/files/0UXsdwNxNmyGzkKJ1m1B" alt="" width="563"><figcaption></figcaption></figure>

Select the **Configuration Tree** tab on the subsequent page and click **Add a purpose**.

<figure><img src="/files/zDlaILc3BVv7tkNPNCao" alt="" width="563"><figcaption></figcaption></figure>

On the subsequent page, your organization will find a list of custom purposes that can be added to your PMP configuration tree.

<details>

<summary>Create new purpose to add</summary>

If the necessary purpose has not been added to your organization's data manager yet, your organization can add the purpose directly from the PMP configuration tree flow.&#x20;

{% hint style="info" %}
While you will not need any additional permissions to add a purpose from this flow, you will be unable to edit or delete the purpose from your organization's data manager without the appropriate permissions.
{% endhint %}

Click **Create a new purpose**.

<figure><img src="/files/UTT3erxjslEMFi52zLmU" alt="" width="563"><figcaption></figcaption></figure>

Use the subsequent modal to give your purpose a name and a description in the provided fields. Click **Save** when finished.

<figure><img src="/files/ihkLaLyiOTBQN2IYkwFz" alt="" width="375"><figcaption></figcaption></figure>

The newly created purpose will be added to your organization's data manager and appear on the list of custom purposes you can add to your organization's PMP configuration tree.

Select the **checkbox** inline with the new purpose name and click **Add to my Configuration Tree**.

<figure><img src="/files/WcrZBAjEJ17LWuzlHONM" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Add purpose from list</summary>

If the custom purpose has already been added to your organization's data manager and appears on the list, your organization can add the purpose to your PMP configuration tree by selecting the **checkbox** inline with the purpose name and clicking **Add to my Configuration Tree**.

<figure><img src="/files/thaan2US0tchEyY9i7lY" alt="" width="563"><figcaption></figcaption></figure>

</details>

Added purposes will appear in your organization's PMP configuration tree so that your organization can map preferences to the purpose.

{% hint style="info" %}
Newly added purposes and their mapped preferences will need to be added to any published preferences widgets and then the widgets republished for the purpose and its preferences to surface to end-users.
{% endhint %}

<figure><img src="/files/izcoyN18aV9UesLNyUD9" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.didomi.io/preference-management-platform-pmp/configuration-tree/add-purpose-to-configuration-tree.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.