# Create new preferences widget

{% hint style="success" %}
**Access Type:** PMP Widgets - Editor

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

A preferences widget is the customizable end-user facing form that your organization surfaces to collect the end-users preferences as defined in your organization's configuration tree. In this article, we will cover how to create a new preferences widget.

{% hint style="warning" %}
**Note**: The directions in this article and section assume your organization is creating and configuring your preferences widget within the Didomi console which limits the deployment options available per [widget format](/preference-management-platform-pmp/preferences-widgets/preferences-widget-formats.md). 

[Click here ](/preference-management-platform-pmp/preferences-widgets.md#didomi-console-vs-didomi-api)to learn more about the differences between utilizing the Didomi console vs the Didomi API and its impact on deployment.  
{% endhint %}

Click **Preferences** on the left-hand panel and ensure the **Widgets** tab is selected on the subsequent page. 

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

Click **Create a widget**.

{% hint style="info" %}
**Prerequisites**: Your organization will need at least [one purpose added](/preference-management-platform-pmp/configuration-tree/add-purpose-to-configuration-tree.md) to your organization's PMP configuration tree before creating a preferences widget.
{% endhint %}

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

Before a preferences widget is created your organization will need to select the format for the preferences widget.

{% hint style="info" %}
[Click here](/preference-management-platform-pmp/preferences-widgets/preferences-widget-formats.md) for additional information on the different preferences widget formats.
{% endhint %}

{% tabs %}
{% tab title="Single purpose widget" %}
Click the radio button for **Single purpose widget** and select **Next step** to continue.

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

On the subsequent screen select a purpose (or preference associated with a purpose) to add to the widget.&#x20;

Click **Generate widget** when finished.

{% hint style="info" %}
Only one purpose (or preference associated with a purpose) can be selected. Once the preferences widget is generated the selected purpose/preference cannot be changed.
{% endhint %}

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

A new preferences widget will be generated with a **Draft** status and added to your list of Active preferences widgets.
{% endtab %}

{% tab title="Multi purpose widget" %}
Click the radio button for **Multi purpose widget** and select **Create a Multi purpose widget** to continue.

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

A new preferences widget will be generated with a **Draft** status and added to your list of Active preferences widgets.
{% endtab %}

{% tab title="Preference center" %}
Click the radio button for **Preference center** and select **Create a Preference center** to continue.

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

A new preferences widget will be generated with a **Draft** status and added to your list of Active preferences widgets.
{% endtab %}
{% endtabs %}

Once a new preferences widget is generated, your organization can continue editing the various components of the widget in the subsequent tabs and publish the widget when finished.&#x20;

{% hint style="info" %}
[Click here](/preference-management-platform-pmp/preferences-widgets/edit-preferences-widget.md) to learn more about editing and publishing your newly created preferences widget.
{% endhint %}


---

# 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/preferences-widgets/create-new-preferences-widget.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.