# Serve on your own domain

> **Plans**
>
> Everything on this page is available on every plan.

Live pages are normally served on our domain. With your own domain set up, they are served on a subdomain of your property's site instead (for example `agents.hana-kyoto.jp`). You do not have to set one up.

## Before you start

Check three things:

- Your role in the console is **Owner** or **Manager**. A **Viewer** sees "Read-only. An owner or manager changes the domain."
- The name is a subdomain of your property's site. For a site at `hana-kyoto.jp`, that is a name like `agents.hana-kyoto.jp`. The site's own domain cannot be used.
- You can change your domain's DNS. If someone else looks after it, see [Ask your web person](https://docs.vibebooking.ai/en/custom-domain#web-person).

## Set it up

1. **Open the Your domain tab**

   Press **Properties** in the menu, then the **Your domain** tab.

2. **Enter a subdomain**

   Under **Set up your domain**, enter the name in **Subdomain to use** and press **Use this name**.

3. **Add the DNS record**

   **The record to add** shows a **Type**, a **Name** and a **Value (points to)**. In your DNS panel, add this one line exactly as shown. **Copy** copies all three at once.

4. **Wait for it to take effect**

   The heading moves from "Waiting for DNS" to "Certificate pending". When everything is ready it reads like "Ready: served on agents.hana-kyoto.jp". While the page is open, it checks again by itself. To check straight away, press **Check again**.

5. **Choose the properties**

   Under **Properties served on this domain**, press **Serve on this domain** for each property. A property served there shows **Served here**. **Stop serving** takes one off.

![A custom domain card, showing the DNS record to add and the properties served on the domain.](https://docs.vibebooking.ai/screenshots/en/custom-domain-record-desktop.webp)
*A custom domain just after it is set: the record to add, and the properties it serves.*

On Cloudflare, set the record's proxy status to "DNS only". While it is "Proxied", we cannot see the record and the setup does not move on. The screen shows the same note under the record.

## Ask your web person

If someone else looks after your DNS, press **Send to your web person**. It opens a page with the record in Japanese and English. Only someone signed in as a member of your account can open that page, so [invite them](https://docs.vibebooking.ai/en/getting-started#invite) first.

An [AI assistant](https://docs.vibebooking.ai/en/ai-assistants) can also add the domain and check its record for you. Choosing the properties it serves stays with you.

On that page, **Check** tells them whether the record has taken effect: "The record is in place." once it has, "Not seen yet." until then.

## What the status means

The heading on the domain screen tells you how far the setup has got. At every stage your pages are served: on our domain until everything is ready, and on yours after.

| Heading | What it means | What to do |
| --- | --- | --- |
| "Waiting for DNS" | We cannot see the record yet. This can take minutes or hours. | Once you have added the record, just wait. |
| "Certificate pending" | The record is in place. It moves on once the HTTPS certificate is issued. | Nothing. |
| "Ready: served on agents.hana-kyoto.jp" | Your pages are served on your domain. | Nothing. |
| A heading like "Your domain stopped pointing at VibeBooking on 9/25/2026" | It was working, and then we could no longer see the record. | See [When the record is gone](https://docs.vibebooking.ai/en/custom-domain#lapsed). |
| "The certificate has not been issued" | The record is in place, but the HTTPS certificate could not be issued. Your pages are still served on our domain. | See [When the certificate has not been issued](https://docs.vibebooking.ai/en/custom-domain#certificate-failed). |

## When it does not work

### You entered the site's own domain

If you see "Use a subdomain, such as agents.hana-kyoto.jp.", the name you entered is the site's own domain (`hana-kyoto.jp`). Put a name such as `agents.` in front of it, as in `agents.hana-kyoto.jp`, and try again.

### The name is used by another account

"That name is already used by another account." means another VibeBooking account has already set up the same name. Check whether someone at your company set it up in a different account. If not, use another name (for example `ai.hana-kyoto.jp`), or [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

### It stays at "Waiting for DNS"

If nothing changes after a few hours, check the record in your DNS panel, in this order:

1. The name is not doubled. Some DNS services want only the `agents` part in the **Name** field. Typing `agents.hana-kyoto.jp` there makes a different name, `agents.hana-kyoto.jp.hana-kyoto.jp`.
2. The type is CNAME, and the value matches **Value (points to)** exactly. Copying it with **Copy** is the safest way.
3. On Cloudflare, the proxy status is "DNS only".
4. No other record (an A record, for example) is left on the same name. If one is, you may not be able to add the CNAME, or we may not see it correctly.

Then press **Check again**.

### DNS could not be checked

"We could not check DNS. This is the last known state; we retry automatically." means our side could not check DNS just now. Nothing is wrong with your setup. The screen keeps the last known state and checks again by itself. Nothing to do.

### When the record is gone

A heading like "Your domain stopped pointing at VibeBooking on 9/25/2026" appears when we can no longer see a record that used to work. Check in your DNS panel whether the record was deleted or its value changed. Meanwhile your pages are served on our domain. Add the record shown under **The record to add** again, and it recovers by itself.

### When the certificate has not been issued

"The certificate has not been issued" appears when we can see your record but could not issue the HTTPS certificate for your own domain. Meanwhile your pages are served on our domain. Check these in order:

1. The record in your DNS panel matches **The record to add** on the screen.
2. Your domain has no CAA record limiting who may issue its certificates. If it has one, that can be the cause. If a web person set up your DNS, ask them to check.

Once it is right, serving on your domain starts on its own. We keep trying to issue the certificate too. If that does not solve it, [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

### A property cannot be served here

A line like "agents.hana-kyoto.jp is not under yado-nara.jp, so it cannot serve this property." means the property's site is on a different domain from the one this name is under. For example, `agents.hana-kyoto.jp` can only serve properties whose site is `hana-kyoto.jp`. For a property on another site, set up that site's subdomain as [another domain of your own](https://docs.vibebooking.ai/en/custom-domain#set-up).

### Something did not finish

These mean the work stopped on our side. Wait a moment and do the same thing again. If it keeps happening, [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

- "That did not save. Try again."
- "That did not change. Try again."
- "That did not work, so the domain is unchanged. Try again."

## Remove your domain

Once removed, your pages are served on our domain again. Only an **Owner** or a **Manager** can remove it.

1. **Press Remove this domain**

   Press it on the card of the domain you want to remove.

2. **Press Remove**

   You are asked something like "Remove agents.hana-kyoto.jp?". Press **Remove**, and the screen shows "Removed agents.hana-kyoto.jp".

3. **Delete the DNS record**

   In your DNS panel, delete the record you added. Any time after removing is fine.

## Contact us

If none of this solves it, press **Still stuck? Contact us** under the error. The screen and the reference go with it, so we can see which step went wrong. How to reach us with no error on screen, and when we reply, are in [Contact us](https://docs.vibebooking.ai/en/troubleshooting#contact).