Public address

A public project is reachable at an address you choose. Every workspace can claim one address of its own, and a project can additionally answer on a domain you already own.

Your Motir address

A workspace claims a single subdomain, and every public project in it answers underneath — so acme gives you acme.motir.site/ROADMAP for a project keyed ROADMAP. A workspace owner or admin claims it, in Project settings under Public address.

A label is lowercase letters, digits and hyphens, three to sixty-three characters. A small set of names is kept back for Motir’s own hosts and for names a reader could mistake for one.

You can rename it a limited number of times, and the pane shows how many renames you have left. The old address keeps working afterwards, and is never released. It redirects to the new one permanently and cannot be claimed by anyone else — including you, later. That is deliberate: a link somebody has already shared must not one day lead somewhere you did not choose.

Connecting your own domain

Connecting a domain you own is available on paid plans — see our plans. Your workspace subdomain is included on every plan and keeps working either way.

A connected domain serves one project, at its root: roadmap.acme.com/ is that project’s overview and roadmap.acme.com/board its board.

You create two kinds of record at your registrar.

1 · Point the domain at us

For a subdomain such as roadmap.acme.com, one CNAME:

For a root domain such as acme.com, an A and an AAAA instead — a root domain cannot take a CNAME, because it already carries the MX and TXT records your mail and your other services depend on:

The settings pane shows you the ownership record below, and does not yet show the pointing record above — use the values on this page for that step. If your DNS provider offers a “proxy” or “cloud” toggle on the record, turn it off: a proxy in front of the record hides your domain from the check and the certificate cannot be issued.

2 · Prove the domain is yours

Add the domain in Project settings under Public address. The pane then shows one TXT record with a token in it, of the shape:

Copy the value from the pane rather than from here — the token is yours alone. Then choose Verify. Once we can see the record we request a certificate, which usually completes in a minute or two. You can close the page; the status keeps moving on its own, and the records stay available under Show DNS records.

What each status means

Which address is the real one

A project can answer at several addresses, and exactly one of them is the primary— the one search engines and social cards are told about. Once a connected domain’s certificate is live you can make it primary; until then the Motir address is.

Every other address redirects to the primary. That includes your motir.co address once you have promoted a domain of your own. Visitors always arrive somewhere that works, and a search engine sees one page rather than three copies competing with each other.

Removing a domain

Removing a connected domain withdraws its certificate and the address stops answering — anyone using it will get an error, and links already shared to it stop working. Your project stays public at its other addresses, so removing a domain never makes a project private.

If something is not working

Three mistakes account for almost every failure, and each shows up differently in the pane.

• A CNAME on a root domain. Most registrars accept it and it does not work. The symptom is a domain that stays Not verified or reaches Failed. Use the A and AAAA records above instead.
• A proxying DNS provider in front of the record. If your provider offers to proxy or accelerate traffic, that hides the real record from us. The symptom is Checking… that never settles. Turn the proxy off for these records.
• A stale ownership record. If you removed and re-added a domain, the token changed. The symptom is Not verified while a TXT record is plainly there. Replace its value with the one the pane shows now.