# Website settings

> Every card on a website's Settings tab, from registration, nameservers and renewal to the DNS zone, DNSSEC and deleting.

Source: https://www.coritan.com/docs/websites/settings/

In the dashboard:

- /dashboard/websites/…/settings: https://www.coritan.com/dashboard/websites

A website's **Settings** tab shows only the cards that apply to the domain. The registrar cards appear for a domain registered with Coritan, **Platform name** for a free name you claimed, and the zone cards when Coritan hosts the domain's DNS. A domain with neither a registration nor a zone here shows **Nothing to configure**.

## Registration

The **Registration** card shows the registrar's status as a badge, and these rows:

| Row | What it shows |
| --- | --- |
| **Domain** | The domain name. |
| **Registrar status** | The registration's status, such as `active` or `pending_transfer`. |
| **Registered** | The registration date. |
| **Expires** | The expiry date, and how many days are left. The count is highlighted when fewer than 30 days are left, and shows **Expired** after the date. |
| **Auto-renew** | **On** or **Off**. |
| **WHOIS privacy** | **On** or **Off**. |
| **Transfer lock** | **Locked** or **Unlocked**. |
| **DNS zone** | **Hosted here**, which opens the **DNS** tab, or **Elsewhere**. |
| **Proxy route** | The web proxy linked to the registration, which opens it in Edge Proxy, or **None**. |
| **Certificate** | The certificate linked to the registration, which opens the **SSL** tab, or **None**. |

The switches, the nameservers, the EPP code and renewing all need the registration to be `active`. [Statuses](/docs/websites/domains/#statuses) explains each status.

## Domain options

| Switch | What it does | Page |
| --- | --- | --- |
| **Auto-renew** | Renews the domain before it expires. | [Renew a domain](/docs/websites/domains/renew-a-domain/) |
| **WHOIS privacy** | Hides your contact details from public WHOIS lookups. | [Turn on WHOIS privacy and transfer lock](/docs/websites/domains/whois-privacy-and-transfer-lock/) |
| **Transfer lock** | Makes the registry refuse transfer requests from other registrars. | [Turn on WHOIS privacy and transfer lock](/docs/websites/domains/whois-privacy-and-transfer-lock/) |

Each switch saves as soon as you change it.

## Nameservers

The **Nameservers** card lists the nameservers the registry sends resolvers to for the domain. **Edit nameservers** opens a list of fields, with **Add nameserver** and a remove button on each field, and **Save nameservers** saves it. The list takes 2 to 13 nameservers. [Change a domain's nameservers](/docs/websites/domains/change-nameservers/) has the steps.

## EPP code

The **EPP code** card has **Reveal EPP code**, which shows the code another registrar needs to take the domain over. The button stays off while **Transfer lock** is on. The code shows once, and **Hide** clears it from the screen. [Transfer a domain to another registrar](/docs/websites/domains/transfer-a-domain-away/) has the steps.

## Renewal

The **Renewal** card extends the registration by 1 to 10 years: choose the period, then select **Renew domain**. [Renew a domain](/docs/websites/domains/renew-a-domain/) has the steps.

## Platform name

For a free name, such as `survival-smp.coritan.gg`, the **Platform name** card shows:

| Row | What it shows |
| --- | --- |
| **Name** | The name you claimed. |
| **Delegated from** | The Coritan domain the name sits under, such as `coritan.gg`. |
| **Claimed** | The date you claimed it. |
| **Renewal** | A free name needs no renewal. It stays yours while its zone exists. |

A free name cannot move to a registrar or use other nameservers. [Claim a free coritan.gg name](/docs/proxies/coritan-gg-names/) explains how it works.

## DNS zone

The **DNS zone** card appears when Coritan hosts the domain's zone.

| Row | What it shows |
| --- | --- |
| **Status** | `active` while Coritan's nameservers answer for the zone. A `suspended` zone has its queries refused ([Failed payments and suspended services](/docs/billing/failed-payments/)). |
| **Serial** | The SOA serial, which goes up with every change to the zone. |
| **Records** | How many records the zone holds. |
| **SOA contact** | The address the zone's SOA record names as responsible for it, `hostmaster@` the domain until you change it. |

To change the contact, select **Edit contact**, enter an address in **SOA contact email** and select **Save contact**. The dashboard asks for a full address, such as `hostmaster@example.com`, and confirms `Zone contact saved.`. Saving raises the zone's serial. [How DNS hosting works](/docs/websites/dns/#the-soa-record) explains the SOA record.

## DNSSEC

The **DNSSEC** card shows whether the zone is signed, and for a signed zone:

| Row | What it shows |
| --- | --- |
| **Algorithm** | The signing algorithm. |
| **KSK key tag** | The tag of the key-signing key, which the DS records name. |
| **ZSK key tag** | The tag of the zone-signing key. |
| **Last ZSK rotation** | The date the zone-signing key last changed. |

An unsigned zone shows `Signing is off for this zone.`

## DS records for the registrar

For a signed zone, the **DS records for the registrar** card lists the DS records to publish at the domain's registrar, each with a copy button. [Set up DNSSEC](/docs/websites/dns/dnssec/) has the steps.

## Delete or release

| Card | Button | What it does | Page |
| --- | --- | --- | --- |
| **Delete the DNS zone** | **Delete zone…** | Deletes the zone and every record in it, after you type the domain. | [Delete a DNS zone](/docs/websites/dns/delete-a-dns-zone/) |
| **Release this name** | **Release name…** | Deletes a free name's zone and everything in it, and returns the name to the pool, after you type the name. | [Claim a free coritan.gg name](/docs/proxies/coritan-gg-names/) |

## Change the zone contact with the API

`PATCH /api/v1/dns/zones/{zone_id}` changes the zone's `soa_email`, the only field it takes:

```bash
curl -X PATCH https://api.coritan.com/api/v1/dns/zones/42 \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"soa_email": "hostmaster@example.com"}'
```

The answer is the zone, with `soa_email` as saved. The API stores the value in lower case. A value without `@`, such as `hostmaster`, stands for that name at the zone itself, `hostmaster@example.com`.

`422` with `No fields to update`
: The body has no `soa_email`.

`422` with `soa_email cannot be empty` or `soa_email too long`
: Send an address of 1 to 255 characters.

`403` with `Access denied`
: The zone is not on your account.

## API

- `PATCH /api/v1/dns/zones/{zone_id}`: Update zone (https://www.coritan.com/docs/api/reference/client/dns/#op-patch-api-v1-dns-zones-zone-id)