# Use a custom domain

URL: https://pro-weather.com/docs/custom-domain

> Point your own domain at your Pro Weather site.

Every site comes with a free `yourname.pro-weather.com` address. On the **Pro
plan** you can also serve your site from a **domain you own**, like
`weather.yourclub.org`, with HTTPS handled for you automatically.

> **A Pro feature**
>
  Custom domains are available on the **Pro plan**. Your free subdomain works on
  every plan, including the trial.

> **Don't have a domain yet?**
>
  You can register one with any domain registrar. We're not affiliated with them,
  but [Cloudflare Registrar](https://domains.cloudflare.com/) is a popular choice:
  it sells domains **at cost** (no markup) and has easy-to-use tools for managing
  your DNS records.

## Add your domain

1. In the dashboard, open your site and go to **Domains**.
2. Enter the domain (or subdomain) you want to use, such as
   `weather.example.com`, and choose **Add domain**.
3. Pro Weather shows you the exact **DNS record(s)** to add at your domain
   registrar, the company you bought the domain from.

## Add the DNS record

The dashboard shows the precise values to use, so always copy them from there. In
general:

- A **subdomain** like `weather.yourclub.org` uses a **CNAME** record pointing at
  Pro Weather.
- A **root domain** like `yourclub.org` uses an **A** record (on the `@` host)
  pointing at the IP address shown, **plus** a **CNAME** on `www` so the `www`
  version is secured too (see below).

### Pro Weather secures the `www` version too

When you connect a **root domain** like `yourclub.org`, Pro Weather automatically
covers **`www.yourclub.org`** as well (and the other way around), so visitors
reach your site over HTTPS whether or not they type `www`.

To turn this on, add the **second record** the dashboard lists for your domain -
a **CNAME** on the **`www`** host pointing at **`cname.vercel-dns.com`** -
alongside the **A** record on `@`. `www.yourclub.org` then gets its own
certificate and **redirects to `yourclub.org`** automatically. (If you added the
`www` version as your main address instead, it's reversed - the root redirects to
`www`.)

This pairing is for a root domain and its `www` only. A deeper subdomain like
`weather.yourclub.org` is served on its own, with no extra record to add.

> **Using Cloudflare?**
>
  Set the record to **DNS only** (grey cloud, proxy off) so verification and SSL
  can complete.

## Verify

After you've added the record, choose **Check again** in the Domains page. Each
domain shows its status:

- **Live**: verified, DNS is pointing at Pro Weather, and your site is being
  served over HTTPS.
- **Awaiting verification**: ownership isn't confirmed yet. This usually means
  the verification TXT record is still pending or was entered incorrectly.
- **DNS not detected**: ownership is confirmed but the CNAME/A record hasn't
  been added yet, isn't pointing at the right target, or hasn't propagated.

Once a domain is **Live**, your site is reachable there with HTTPS issued and
renewed automatically.

  DNS changes can take anywhere from a few minutes to 48 hours to propagate
  worldwide. If verification doesn't pass right away, wait an hour and choose
  **Check again**.

## Troubleshooting

### Status stays on "Awaiting verification"

This means Pro Weather hasn't confirmed you own the domain. Double-check that
you've added the **TXT verification record** shown in the dashboard. It must
match the exact value. If using a subdomain like `weather.example.com`, the TXT
record belongs on `weather.example.com`, not the root domain.

### Status stays on "DNS not detected"

Ownership is confirmed but your A or CNAME record isn't pointing at Pro
Weather's servers yet:

- **Check the target**: make sure the A record IP or CNAME target matches
  exactly what the dashboard shows. A stray space or typo will break it.
- **Check the name**: a subdomain like `weather.example.com` needs a CNAME on
  `weather`, not `@` or `www`. A root domain like `example.com` needs an A
  record on `@`.
- **Wait and retry**: DNS changes are cached by internet providers. Use a tool
  like [whatsmydns.net](https://whatsmydns.net) to check if your record has
  propagated globally, then choose **Check again**.
- **Cloudflare users**: set the record to **DNS only** (grey cloud). The
  orange proxy (cloud) can interfere with verification and SSL issuance.

### `www` shows a warning or doesn't load

Your root domain works, but `www.yourdomain.com` shows an "unsecure connection"
or won't open. The **`www` CNAME** isn't in place yet: add a **CNAME** on the
**`www`** host pointing at **`cname.vercel-dns.com`** (the dashboard lists it
under your domain), then wait a few minutes for the certificate to issue.

### Cloudflare proxying (orange cloud)

If you use Cloudflare as your DNS provider, make sure the record shows the
**grey cloud** (DNS only). When the orange cloud (proxy) is enabled, Cloudflare
hides Pro Weather's real IP and Vercel can't complete the SSL handshake. Your
domain will stay on a non-Live status indefinitely.

> **I still can't get it working**
>
  Email [hello@pro-weather.com](mailto:hello@pro-weather.com) and include your
  domain name and a screenshot of the DNS record you added. We'll help
  troubleshoot.

## Handy resources

- **[whatsmydns.net](https://whatsmydns.net)**: check if your DNS record has
  propagated worldwide.
- **[dns.google](https://dns.google)**: query specific record types (A, CNAME,
  TXT) to verify your exact values.
- **[Let's Debug](https://letsdebug.net)**: run a diagnostic on a domain for
  common SSL/DNS misconfigurations.
- **Your registrar's help center**: each registrar has a slightly different DNS
  editor. Search for "how to add a CNAME record" or "how to add an A record" at
  your registrar's docs.

## Next steps

- [Customize your branding](https://pro-weather.com/docs/customizing/appearance)
- [Manage your plan](https://pro-weather.com/docs/account-billing/subscription)
