# Claim a free coritan.gg name > Claim a free name under a Coritan domain such as coritan.gg, use it for your sites and servers, or release it. Source: https://www.coritan.com/docs/proxies/coritan-gg-names/ A *coritan.gg name* is a free name under `coritan.gg`, such as `alex.coritan.gg`, that Coritan lends to your account. Coritan creates a DNS zone for it on your account, so you can use it for mailboxes, a website, a game server's address or anything else you would put on a domain you own. Claim one when you want an address without buying a domain. The name needs no renewal, and stays on your account while its DNS zone exists. A `@coritan.gg` mailbox, such as `alex@coritan.gg`, is a separate thing ([Get a coritan.gg mailbox](/docs/mail/webmail/claim-a-mailbox/)). ## Before you begin - An account can hold 3 names. When yours holds 3, [release one](#release-a-name) before you claim another. - Choose a name that follows the [name rules](#name-rules). Join addresses and claimed names share the names under `coritan.gg`, so a name that a join address uses is not free. ## Claim a name 1. Open the claim form from one of these places: - The dashboard's [home page](https://www.coritan.com/dashboard), while your account holds no name: select **Claim a name** on the card that offers a free `coritan.gg` name. Right after you sign up with your own email address, the dashboard opens with the form already showing. - [Websites](https://www.coritan.com/dashboard/websites): select the button that offers a free `coritan.gg` name. Once you hold a name, open the **More website actions** menu and select **Claim another name…** instead. - A form that asks for a domain, such as a mail service's domain or a web proxy's hostname: select the claim link under the field. With no name yet, the link follows `No domain?`. 2. If the form shows **Under**, choose the Coritan domain to claim the name under. The form shows it only when Coritan offers more than one. 3. In **Name**, type the name, such as `alex`. The form checks the name as you type, and shows `alex.coritan.gg is available` when it is free ([Name rules](#name-rules)). To use a name made from your profile instead, select one of the names beside **Try**. The form offers up to 3 free names, made from your name, your company and your email address. Under the field, the form also says how many more names the account can claim. 4. Select the claim button, which reads `Claim alex.coritan.gg` once the name is available, or press Enter in **Name**. ## Name rules A name is one label under `coritan.gg`, and must follow these rules: - It has 3–32 characters. - It uses lowercase letters, digits and hyphens, with no hyphen at either end. - It has no two hyphens in a row. - No join address and no other claim already has it. - It is not a reserved name. The field changes what you type as you go. It turns capitals into lowercase letters and drops every character other than letters, digits and hyphens, so `Alex_SMP` becomes `alexsmp`. These names are reserved: `abuse`, `account`, `accounts`, `admin`, `administrator`, `api`, `app`, `apps`, `assets`, `auth`, `autoconfig`, `autodiscover`, `billing`, `blog`, `bucket`, `buckets`, `cdn`, `checkout`, `client`, `clients`, `console`, `coritan`, `dashboard`, `ddos`, `demo`, `dev`, `developer`, `developers`, `dns`, `docs`, `edge`, `example`, `ftp`, `game`, `games`, `git`, `help`, `hostmaster`, `imap`, `internal`, `invoice`, `invoices`, `jmap`, `legal`, `login`, `mail`, `minecraft`, `mobile`, `mta-sts`, `mx1`, `mx2`, `mx3`, `news`, `no-reply`, `noreply`, `ns1` to `ns8`, `oauth`, `official`, `panel`, `pay`, `payment`, `payments`, `play`, `pop`, `pop3`, `portal`, `postmaster`, `privacy`, `proxy`, `register`, `root`, `secure`, `security`, `sftp`, `shield`, `shop`, `signin`, `signup`, `smtp`, `ssh`, `sso`, `staff`, `staging`, `static`, `status`, `storage`, `store`, `support`, `sys`, `system`, `terms`, `test`, `testing`, `verified`, `verify`, `vpn`, `waf`, `webmail`, `webmaster` and `www`. Coritan can reserve more, and the API's `rules.reserved` lists every reserved name ([With the API](#with-the-api)). ## Use the name The name appears in [Websites](https://www.coritan.com/dashboard/websites) with a `coritan.gg` badge, and works like a domain you own. Forms that ask for a domain list your names beside **Your names:** or **Under your name:**, and selecting one fills in the field. | Use | Example | Page | |---|---|---| | Mailboxes | `you@alex.coritan.gg` | [Add a domain to Mail Hosting](/docs/mail/mail-hosting/add-a-domain/) | | Mail sent through SMTP Relay | `alex.coritan.gg` | [Add a sending domain to SMTP Relay](/docs/mail/smtp-relay/add-a-sending-domain/) | | A website | `alex.coritan.gg` or `www.alex.coritan.gg` | [Create a web proxy](/docs/proxies/web-proxies/create-a-web-proxy/) | | A game server | `play.alex.coritan.gg` | [Use your own domain for a join address](/docs/proxies/join-addresses/custom-domain/) | | An instance's name | `vm.alex.coritan.gg` | [Manage an instance's addresses and names](/docs/cloud-compute/networking/) | | Reverse DNS for a floating IP | `mail.alex.coritan.gg` | [Set reverse DNS for a floating IP](/docs/floating-ips/reverse-dns/) | | Records of your own | Any record the zone takes | [Add, edit and delete DNS records](/docs/websites/dns/manage-dns-records/) | Coritan publishes the mail records for a claimed name itself, so a mail domain needs no DNS step ([Mail DNS records](/docs/mail/dns-records/)). A join address can use a name under yours, such as `play.alex.coritan.gg`, but not the name itself. Coritan's nameservers answer for the name, and it cannot use other nameservers or move to a registrar ([Website settings](/docs/websites/settings/#platform-name)). Coritan signs the zone with DNSSEC and publishes its DS records in `coritan.gg`, so DNSSEC needs no step from you ([Set up DNSSEC](/docs/websites/dns/dnssec/)). Coritan also requests a wildcard certificate, such as `*.alex.coritan.gg`, which covers the name and every name directly under it ([How SSL/TLS certificates work](/docs/websites/ssl/)). ## Limits | Limit | Value | |---|---| | Names an account can hold | 3 | | Length of a name | 3–32 characters | | DNS zones an account can hold, claimed names included | 100 | | Claims | 6 an hour, for your account | | Availability checks | 60 a minute, for your account | [Rate limits](/docs/api/rate-limits/#actions-with-their-own-budget) lists the budgets for every action. ## Release a name > [!CAUTION] > Releasing a name deletes its DNS zone with every record, load balancer and origin pool in it. Mail domains, web proxies, certificates and game server addresses under the name stop working, and anyone can claim the name afterwards. You cannot undo a release. 1. In the dashboard, go to [Websites](https://www.coritan.com/dashboard/websites) and open the name, such as `alex.coritan.gg`. 2. Open the **Settings** tab. 3. On the **Release this name** card, select **Release name…**. 4. Type the full name, such as `alex.coritan.gg`. 5. Select **Release name**. A release does not cancel a service that used the name, such as a mail service or a web proxy. [Cancel the service](/docs/billing/cancel-a-service/) as well when you no longer need it. ## Result After a claim, the form shows **Your new name** and `alex.coritan.gg is yours`. Coritan has created the name's DNS zone, added its NS and DS records to `coritan.gg` and requested its wildcard certificate. Select a card to use the name at once: **Add mailboxes**, **Point a website at it**, **Use it for a game server** or **Edit its DNS**. **Done** closes the form. After a release, the dashboard shows `alex.coritan.gg released.` and opens the Websites list, which no longer lists the name. ## Troubleshooting `At least 3 characters` : The name is shorter than 3 characters. Add to it. `Lowercase letters, digits and hyphens; not starting or ending with a hyphen` : The name starts or ends with a hyphen. Remove it. `No double hyphens` : The name has two hyphens in a row. Remove one. `That name is reserved` : Coritan keeps the name back ([Name rules](#name-rules)). Choose another. `Already in use by a game server address` : A join address uses the name. Choose another. `Already taken` : Another account holds the name, or claimed it after the form checked it. Choose another. `Could not check the name:` followed by a reason : The availability check failed. When the reason is `Too many requests for this action. Please wait and try again.`, the account made 60 checks in the past minute. Wait a minute, then type the name again. `This account holds all 3 of its coritan.gg names. Release one from its Websites settings to claim another.` : The account holds as many names as it can. [Release one](#release-a-name) to claim another. **Claim another name…** is greyed out for the same reason. **Could not claim the name** : Coritan refused the claim. The message under the title says why, and is one of the messages on this list. `You can claim up to 3 coritan.gg names` : The account already holds 3 names. [Release one](#release-a-name) first. `Zone limit reached (100)` : The account already has 100 DNS zones, and a name needs one more. [Delete a zone](/docs/websites/dns/delete-a-dns-zone/) that you no longer use. `Too many requests for this action. Please wait and try again.` : The account tried to claim a name 6 times in the past hour. Wait, then try again. The new name does not resolve : The form said `We are still finishing the delegation from coritan.gg. The name starts resolving when that is done.` Coritan has not added the records in `coritan.gg` that point at your name. [Contact support](/docs/support/conversations/) with the name if it still does not resolve. `coritan.gg is the platform's own domain; claim a name under it first` : You entered `coritan.gg` itself in a form, such as a mail domain. Enter a name you hold, such as `alex.coritan.gg`, or a name under it. `Claim a coritan.gg name before using play.coritan.gg; it is not yours yet` : The name you entered is under `coritan.gg`, but not under a name you hold. Claim the name first, or use one under yours, such as `play.alex.coritan.gg`. **Could not release the name** : The release failed, and the message gives the reason. Try again, or [contact support](/docs/support/conversations/). A name you did not release has gone : Coritan can take a name back after a trademark or abuse complaint, which deletes its zone as a release does. [Contact support](/docs/support/conversations/) to ask why. ## Related - [Website settings](/docs/websites/settings/) - [How DNS hosting works](/docs/websites/dns/) - [Use your own domain for a join address](/docs/proxies/join-addresses/custom-domain/) - [Add a domain to Mail Hosting](/docs/mail/mail-hosting/add-a-domain/) - [Get a coritan.gg mailbox](/docs/mail/webmail/claim-a-mailbox/) ## With the API Read the domains on offer, your names, the rules and the reserved list with [`GET /client/platform-domains`](/docs/api/reference/client/platform-domains/#op-get-api-v1-client-platform-domains): ```bash curl https://api.coritan.com/api/v1/client/platform-domains \ -H "Authorization: Bearer $CORITAN_TOKEN" ``` ```json { "suffixes": ["coritan.gg"], "claims": [ { "id": 17, "zone_id": 42, "suffix": "coritan.gg", "label": "alex", "fqdn": "alex.coritan.gg", "created_at": "2026-09-16T10:24:00", "zone_status": "active", "record_count": 6 } ], "limit": 3, "remaining": 2, "rules": { "min_length": 3, "max_length": 32, "pattern": "^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?$", "reserved": ["abuse", "account", "accounts", "admin"] }, "suggestions": { "web": "www.alex.coritan.gg", "mail": "alex.coritan.gg", "play": "play.alex.coritan.gg", "vm": "vm.alex.coritan.gg", "ip": "ip.alex.coritan.gg", "app": "app.alex.coritan.gg", "sftp": "sftp.alex.coritan.gg", "db": "db.alex.coritan.gg" } } ``` The example shortens `reserved`, which lists every reserved name. `id` is the claim's ID, which the release and certificate calls take, and `zone_id` is the name's zone in the DNS API. `remaining` is `null` when an account can hold any number of names. `suggestions` proposes a name for each product under the first name you claimed, and is `null` while you hold none. ### Check a name Check a name with [`GET /client/platform-domains/availability`](/docs/api/reference/client/platform-domains/#op-get-api-v1-client-platform-domains-availability): ```bash curl "https://api.coritan.com/api/v1/client/platform-domains/availability?label=alex" \ -H "Authorization: Bearer $CORITAN_TOKEN" ``` ```json {"available": true, "fqdn": "alex.coritan.gg", "reason": null} ``` `label` takes 1–63 characters, or the call answers `422`. `suffix` is the domain to claim under, and defaults to the first one in `suffixes`. The call turns capitals into lowercase letters and trims spaces, but changes nothing else, unlike the dashboard's field. A name you cannot claim answers `"available": false` with a `reason`: one of the messages in [Troubleshooting](#troubleshooting), or `Enter a name`, `At most 32 characters` or `That suffix is not offered`. The check allows 60 calls a minute for your account. ### Create a claim Claim the name with [`POST /client/platform-domains/claims`](/docs/api/reference/client/platform-domains/#op-post-api-v1-client-platform-domains-claims). The body takes `label` and, optionally, `suffix`: ```bash curl -X POST https://api.coritan.com/api/v1/client/platform-domains/claims \ -H "Authorization: Bearer $CORITAN_TOKEN" \ -H "Content-Type: application/json" \ -d '{"label": "alex"}' ``` ```json { "zone_id": 42, "fqdn": "alex.coritan.gg", "label": "alex", "suffix": "coritan.gg", "created_at": "2026-09-16T10:24:00.412733+00:00", "parent_delegated": true, "dnssec": {"enabled": true, "ds_published": true}, "certificate": {"domain": "*.alex.coritan.gg", "queued": true, "job_id": 90121, "reason": null} } ``` The call answers `201`. `parent_delegated` is `false` when Coritan could not yet add the name's NS records to `coritan.gg`, and the name does not resolve until it has. `certificate.queued` is `false` with a `reason` when Coritan did not request the wildcard certificate; request it again as [Request the wildcard certificate again](#request-the-wildcard-certificate-again) shows. A refused claim answers with the reason as `detail`: | Status | When | |---|---| | `403` | `You can claim up to 3 coritan.gg names`, or `Zone limit reached (100)`. | | `409` | `Already taken` or `Already in use by a game server address`. | | `422` | The name breaks a [rule](#name-rules), or `That suffix is not offered`. | | `429` | The account sent 6 claims in the past hour ([Rate limits](/docs/api/rate-limits/#actions-with-their-own-budget)). | ### Release a claim Release the name with [`DELETE /client/platform-domains/claims/{claim_id}`](/docs/api/reference/client/platform-domains/#op-delete-api-v1-client-platform-domains-claims-claim-id). The release deletes the zone and everything in it, as [Release a name](#release-a-name) describes, and asks for no confirmation: ```bash curl -X DELETE https://api.coritan.com/api/v1/client/platform-domains/claims/17 \ -H "Authorization: Bearer $CORITAN_TOKEN" ``` ```json {"ok": true, "fqdn": "alex.coritan.gg"} ``` A claim ID that is not one of yours answers `404` `Claim not found`. Deleting the name's zone with the DNS API releases the name too ([Delete a DNS zone](/docs/websites/dns/delete-a-dns-zone/)). ### Request the wildcard certificate again Coritan requests the wildcard certificate when you claim a name. When that request did not go ahead, or the certificate order failed, request it again with [`POST /client/platform-domains/claims/{claim_id}/certificate`](/docs/api/reference/client/platform-domains/#op-post-api-v1-client-platform-domains-claims-claim-id-certificate): ```bash curl -X POST https://api.coritan.com/api/v1/client/platform-domains/claims/17/certificate \ -H "Authorization: Bearer $CORITAN_TOKEN" ``` ```json {"domain": "*.alex.coritan.gg", "queued": true, "job_id": 90188, "reason": null} ``` The call answers `202`, and the name's **SSL** tab shows the certificate once it is issued. A claim ID that is not one of yours answers `404` `Claim not found`, and a claim whose zone is gone answers `409` `The claim's zone no longer exists`. When Coritan does not queue the request, the call answers `409` with the reason: `already in progress` while an earlier request for the name is still waiting, a reason that starts with `Rate limit:` when too many certificates were issued under `coritan.gg` in the past 7 days, or `coritan.gg is not delegated to the platform's nameservers yet`. Try again later. ## API - `GET /api/v1/client/platform-domains`: Overview (https://www.coritan.com/docs/api/reference/client/platform-domains/#op-get-api-v1-client-platform-domains) - `GET /api/v1/client/platform-domains/availability`: Check availability (https://www.coritan.com/docs/api/reference/client/platform-domains/#op-get-api-v1-client-platform-domains-availability) - `POST /api/v1/client/platform-domains/claims`: Create claim (https://www.coritan.com/docs/api/reference/client/platform-domains/#op-post-api-v1-client-platform-domains-claims) - `DELETE /api/v1/client/platform-domains/claims/{claim_id}`: Delete claim (https://www.coritan.com/docs/api/reference/client/platform-domains/#op-delete-api-v1-client-platform-domains-claims-claim-id) - `POST /api/v1/client/platform-domains/claims/{claim_id}/certificate`: (Re)queue the .