# Renew a domain

> Renew a domain registered with Coritan for one to ten years, or turn on auto-renew so it renews before it expires.

Source: https://www.coritan.com/docs/websites/domains/renew-a-domain/

In the dashboard:

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

Renew a domain to extend its registration past its expiry date. You can renew it by hand for 1–10 years at a time, or leave auto-renew on so that Coritan renews it before it expires. When a domain expires, its registry can stop it resolving and later release it for anyone to register.

## Before you begin

- The domain must be registered with Coritan. For a domain registered elsewhere, renew it at that registrar.
- The registration must be `active`. See [Troubleshooting](#troubleshooting) when it is not.

## Renew by hand

1. In the dashboard, go to [Websites](https://www.coritan.com/dashboard/websites), open the domain and select the **Settings** tab.
2. In the **Renewal** card, choose how many years to add, from 1 to 10.
3. Select **Renew domain**.

The dashboard confirms the renewal. The **Expires** date updates once Coritan next reads the registration back from the registry.

## Turn auto-renew on or off

1. On the domain's **Settings** tab, find the **Domain options** card.
2. Turn **Auto-renew** on or off.

With auto-renew on, Coritan renews the domain for one year when it is within 14 days of its expiry date. It tries again the next day when a renewal fails. With auto-renew off, Coritan emails you 30, 14, 7, 3 and 1 day before the domain expires.

## Result

The **Registration** card on the **Settings** tab shows the new **Expires** date and whether **Auto-renew** is on. In the Websites list, the **Registrar** column shows the **Auto-renew** badge, or **Manual renewal**.

## Troubleshooting

`Registration not found or not active`
: The dashboard renews only a registration whose status is `active`. Within 30 days of its expiry date a registration is `expiring_soon`, and once the registry reports it expired it is `expired`. Contact [support](/docs/support/) to renew a domain in either state.

`Could not save the Auto-renew setting`
: The switch could not be changed. The registration may not be `active`, or the registry did not answer. Try again later.

`Renewal failed: …`
: The registry refused the renewal or did not answer. The expiry date has not changed. Try again later.

`Duration must be between 1 and 10 years`
: The API accepts a `duration` from 1 to 10.

## Related

- [How domain registration works](/docs/websites/domains/)
- [Website settings](/docs/websites/settings/)

## With the API

Renew registration `7` for two years. The body's `duration` is 1 when you leave it out:

```bash
curl -X POST https://api.coritan.com/api/v1/domains/registrations/7/renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"duration": 2}'
```

```json
{"message": "Domain renewed successfully", "domain": "example.com", "new_expiry": "2029-09-16T10:04:00+00:00"}
```

The answer is `202`, and `new_expiry` is the date the registry reported, or `null` when it reported none. Turn auto-renew on or off with `enabled`:

```bash
curl -X PUT https://api.coritan.com/api/v1/domains/registrations/7/auto-renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
```

```json
{"message": "Auto-renew disabled", "domain": "example.com"}
```

## API

- `POST /api/v1/domains/registrations/{reg_id}/renew`: Request domain renewal (https://www.coritan.com/docs/api/reference/client/domains/#op-post-api-v1-domains-registrations-reg-id-renew)
- `PUT /api/v1/domains/registrations/{reg_id}/auto-renew`: Toggle auto-renewal for a domain (https://www.coritan.com/docs/api/reference/client/domains/#op-put-api-v1-domains-registrations-reg-id-auto-renew)