# Use your own domain

A default URL is assigned to your widget:

```
https://organization-widget-id.preference-center.org/
```

We recommend using your own domain name instead, such as [`https://privacy.company-name.com`](https://privacy.company-name.com)

{% hint style="warning" %}
To use a domain in a widget:

* The domain must already exist ([see how to create a domain](https://developers.didomi.io/api-and-platform/domains)).
* The domain must be in **Ready** status.
* The domain must have the correct **usage** (**Load a webpage** or `preference-center` in the API).
* The domain must **not be assigned to another widget**.
  {% endhint %}

## Update the widget with the custom domain

You can update the widget with a custom domain by sending a **PATCH** request to the `/widgets/{id}` endpoint.

Set the `domain` property to **custom** and include the `custom_domain_id` property with the domain ID (or domain name) you want to assign.

```json
PATCH https://api.didomi.io/widgets?organization_id=YOUR_ORG_ID

{
  "domain": "custom",
  /**
   * custom_domain_id corresponds to your custom domain
   * ex: preferences.didomi.io
   */  
  "custom_domain_id": "String"

}

```

{% hint style="info" %}
To apply your changes, you must [deploy the widget](https://developers.didomi.io/api-and-platform/widgets/privacy-widgets/deploy-a-widget).
{% endhint %}

If you struggle with configuring your custom domain, send an email to <support@didomi.io> or to the person you have been in touch with at Didomi to let us know what custom domain you will be using and that the [setup](https://developers.didomi.io/api-and-platform/domains) is done on your side.
