# Create TLD and Associated DNS Zone (Designate)

## Problem

User needs to create a top-level domain (TLD) and a DNS zone which will utilize this TLD.

## Environment

* Platform9 Managed OpenStack - All Versions
* Designate

## Procedure

1. Create the TLD.

{% tabs %}
{% tab title="None" %}

```none
# openstack tld create --name [tld]
```

{% endtab %}
{% endtabs %}

2. Create one or more DNS zones which utilize this TLD.

{% tabs %}
{% tab title="None" %}

```none
# openstack zone create --email admin@domain.tld [domain].[tld].
```

{% endtab %}
{% endtabs %}

**Note**: The trailing dot **must** be included. Also, if any TLDs are created within Designate, zone creation is restricted \_only\_ to those.

## Additional Information

* [OpenStack Docs: Managing Top-Level Domain Names (API)](https://docs.openstack.org/designate/latest/admin/tlds.html)
* [OpenStack Docs: Working with Zones](https://docs.openstack.org/python-designateclient/latest/user/shell-v2.html#working-with-zones)