> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dcal/share/custom-link.md).

# Custom link

Replace the six-character code in your dCal links with a word you choose, such as book.dcal.ai/acme/jdoe. Included with a Dapta AI subscription: the rules, where to set it, what a free account sees, a

Every dCal address starts with a six-character code for your workspace, like `k7m2xq`. A **custom link** replaces that code with a word you choose, usually your company name, so your links are easy to read and remember:

```
https://book.dcal.ai/k7m2xq/jdoe/intro-call
https://book.dcal.ai/acme/jdoe/intro-call
```

The custom link is included with a Dapta AI subscription, together with hiding the Dapta branding. Everything else in dCal is free.

***

## How it works

* **One per workspace.** The custom link belongs to the workspace, not to one person. Once it is set, the profile pages, events and team pages of everyone in the workspace use it.
* **Owners and admins set it.** If you are a member, ask an owner or an admin of your workspace.
* **Old links keep working.** The six-character code still opens the same pages and sends visitors to the new address. If you change or remove the custom link later, the previous one keeps working too. Links you printed, sent or embedded never break because of it. Older links with `app.dcal.ai` in them keep working too.

***

## Set your custom link

**Step 1:** Open **Settings**, then **Booking Page**. Under **Profile**, find **Custom link (vanity)**. The field shows your current six-character code in grey.

**Step 2:** Type the word you want, for example `acme`. The **Your booking link** field above updates as you type.

**Step 3:** Click **Save** at the top right of the page. You see **Saved.**

| Rule           | Detail                                                                                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Characters     | Lowercase letters, numbers and hyphens. It must start and end with a letter or a number, with no double hyphens.                                       |
| Length         | 3 to 30 characters.                                                                                                                                    |
| Unique         | No other workspace in dCal can have it.                                                                                                                |
| Reserved words | A few words used by the product itself cannot be a custom link, such as `admin`, `api`, `booking`, `calendar`, `help`, `login`, `settings` and `team`. |

If the word cannot be used, a message in English appears at the top of the page:

| Message                                                      | What to do                                                                           |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| *That link is already in use.*                               | Another workspace has it. Try a variation, for example with your city or your trade. |
| *That word is reserved.*                                     | Choose another word.                                                                 |
| *Use 3-30 lowercase letters, numbers, or hyphens.*           | Check the length and the characters.                                                 |
| *Vanity links are included with your Dapta AI subscription.* | Your workspace does not have a Dapta AI subscription. See below.                     |

To go back to the six-character code, empty the field and click **Save**.

***

## What a free account sees

Without a Dapta AI subscription, the **Profile** section shows a line instead of the field: **Custom links are included with your Dapta AI subscription.**, with a **Learn more** link.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-91db08a3a3165eabce47fafa72d31c5e9ff37fca%2Fdcal-custom-link-02-free-account.png?alt=media" alt="On a free account, the boxed line Custom links are included with your Dapta AI subscription. with its Learn more link, under the Embed on your site button"><figcaption><p>On a free account, your links keep the six-character code.</p></figcaption></figure>

> **💡 Tip:** dCal checks the subscription of your workspace's owner. If your company pays for Dapta AI and you still see **Learn more**, make sure the owner of this dCal workspace signs in with the same email as the owner of your Dapta AI account.

The other feature included with a Dapta AI subscription is hiding the Dapta branding on your pages. See [The Dapta badge](https://docs.dapta.ai/dcal/design/dapta-branding.md).

***

## Related

* [Your links and profile page](https://docs.dapta.ai/dcal/share/your-booking-page.md)
* [Embed on your website](https://docs.dapta.ai/dcal/share/embed.md)
* [The Dapta badge](https://docs.dapta.ai/dcal/design/dapta-branding.md)
* [Members and roles](https://docs.dapta.ai/dcal/account/members-and-roles.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dcal/share/custom-link.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
