Setting up a custom domain

A custom domain is a hostname you own, such as trip.example.com, that your trip takes as its address in place of the one TripEagle gave it. It is always a subdomain of yours, never a bare domain such as example.com. You point it at TripEagle with one CNAME record at your DNS host:

A trip has at most one custom domain, and no two trips share one. Only the trip's organizer can add, change or remove it, in the studio's Settings. Replacing or removing it lets it go: it isn't kept as a former address for the trip.

You can send this page to whoever runs your DNS. They don't need to sign in to anything: the record above is all they need.

1. In the Cloudflare dashboard, open your domain, then DNS, then Records.
2. Select Add record and choose the type CNAME.
3. For Name, enter the subdomain's own label, such as trip for trip.example.com.
4. For Target, enter domains.tripeagle.app.
5. Switch Proxy status off, so the cloud is grey and it reads DNS only. Leave TTL on Auto.
6. Select Save.

The proxy has to be off. With it on, Cloudflare answers with its own addresses instead of the record, so TripEagle can't find the CNAME and the domain fails.

1. Sign in to GoDaddy and open your domain's DNS page, from Domains, then DNS.
2. Select Add New Record and choose the type CNAME.
3. For Name, enter the subdomain's own label, such as trip for trip.example.com.
4. For Value, enter domains.tripeagle.app.
5. Leave TTL as it is, and select Save.

1. Sign in to Namecheap, open Domain List, select Manage beside your domain, then open Advanced DNS.
2. Under Host Records, select Add New Record and choose CNAME Record.
3. For Host, enter the subdomain's own label, such as trip for trip.example.com.
4. For Value, enter domains.tripeagle.app.
5. Leave TTL on Automatic, and select the tick to save it.

1. Sign in to Squarespace Domains, open your domain, then DNS.
2. Under Custom records, select Add record and choose the type CNAME.
3. For Host, enter the subdomain's own label, such as trip for trip.example.com.
4. For Data, enter domains.tripeagle.app.
5. Select Save.

1. In the Route 53 console, open Hosted zones and select your domain's zone.
2. Select Create record.
3. For Record name, enter the subdomain's own label, such as trip for trip.example.com.
4. For Record type, choose CNAME, and leave Alias off.
5. For Value, enter domains.tripeagle.app.
6. Leave TTL at 300 and the routing policy on Simple routing, then select Create records.

Every DNS host has a page of DNS records, sometimes called a zone or a zone editor. Add one record there:

Most hosts want only the subdomain's own label as the name, such as trip, and add your domain after it. If yours asks for the full name, enter trip.example.com. If the name it shows ends up as trip.example.com.example.com, enter only the label instead.

A name can have only one CNAME record and nothing else beside it, so remove any other record for the same subdomain first.

Pending means TripEagle is waiting to find your CNAME record and then to have a certificate issued for the domain. Once the record is in place this usually takes a few minutes.

A change to DNS takes time to propagate: places that looked up your subdomain before keep the old answer until it expires, which can take a few hours, and in rare cases up to two days. While it is pending, TripEagle keeps checking by itself.

If it is still pending after a day, check the record against the table above, at the same subdomain you typed in Settings. A DNS lookup site can show what the world sees: a lookup of your subdomain's CNAME should answer domains.tripeagle.app.

Settings says why it failed, in one of the lines below. Fix what it names at your DNS host, then select Check again.