# CNAME / Custom Domain

> Give your published apps and shared links your own web address: a free Taskade subdomain on every plan, or your own domain on Pro and above.

- Source: https://www.taskade.com/learn/projects/custom-domain
- Section: Projects
- Updated: 2026-11-09
- Index of all pages: https://www.taskade.com/learn/llms.txt

Give your published apps and shared links an address that your customers trust. Pick a free Taskade subdomain on any plan, or connect a custom domain with a CNAME record on Pro and above.

> **TL;DR:** Open **App settings → Launch → Domains** on your [Taskade Genesis](https://www.taskade.com/learn/genesis/first-app) app. A free `taskade.site` subdomain works on every plan. To use your own domain, such as `app.yourcompany.com`, click **Connect**, then add the CNAME record that Taskade shows at your DNS provider. Taskade adds the SSL certificate for you. Custom domains need Pro, Business, Max, or Enterprise.

In this guide, you will:

- Pick a free Taskade subdomain
- Connect a domain that you own with a CNAME record
- Buy a new domain in Taskade
- Fix the common domain errors

![A published app on a custom domain](https://www.taskade.com/static_images/learn/projects/custom-domain-8ded2b47.jpg)

## Before You Start

A free subdomain works on every plan. Your own domain needs Pro or above.

| Requirement | Details |
| --- | --- |
| Plan for a free Taskade subdomain | Every plan, Free included |
| Plan for your own domain | Pro (up to 10 custom domains), or Business, Max, or Enterprise (unlimited) |
| What you need | A published app, and access to the DNS settings at your domain provider. See [Create Your First App](https://www.taskade.com/learn/genesis/first-app). |
| Time | About 5 minutes, plus the time that your DNS provider takes to update |

## Choose a Domain Type

The **Domains** panel offers four ways to get a web address.

```mermaid
graph TD
    A[Open App settings, then Launch, then Domains] --> B{Which address?}
    B -->|Free| C[Pick your own Taskade subdomain]
    B -->|Own domain| D[Add the CNAME record at your DNS provider]
    B -->|New domain| E[Buy a brand-new domain]
    D --> F[Taskade adds SSL, domain goes live]
    style A fill:#0d1b2a,color:#7dd3fc,stroke:#38bdf8,stroke-width:1.5px
    style B fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
    style C fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
    style D fill:#1a140a,color:#ffb74d,stroke:#e65100,stroke-width:1.5px
    style E fill:#1a140a,color:#ffb74d,stroke:#e65100,stroke-width:1.5px
    style F fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
```

| Option in the panel | Example | Plan | SSL |
| --- | --- | --- | --- |
| **Free Taskade address** | `your-app.taskade.app`, made when you publish | Every plan | Automatic |
| **Pick your own Taskade subdomain** | `mycompany.taskade.site` | Every plan | Automatic |
| **Connect a domain you own** | `app.yourdomain.com` or `yourdomain.com` | Pro (up to 10) and above (unlimited) | Automatic |
| **Buy a brand-new domain** | A new domain that Taskade sets up for you | Every paid plan. It does not count toward the limit | Automatic |

A workspace domain also brands the public links that you share from that workspace:

| Area | What you share | Branded URL |
| --- | --- | --- |
| Published Taskade Genesis apps | Client portals, booking systems, dashboards | `myapp.my-domain.com` |
| Published projects | Timelines, deliverables, or progress updates. No account needed to view. | `mymarketing.my-domain.com/a/123456abc123` |
| Published automations | Processes and templates that others can reuse | `mymarketing.my-domain.com/flow-template/workflow456` |
| Public forms | Contact forms, surveys, or event sign-ups | `mymarketing.my-domain.com/f/contact789` |

> **Note:** A custom domain on the Home space does not change the other spaces or apps. Set a domain for each folder or team separately.

![Choosing a domain type for an app](https://www.taskade.com/static_images/learn/projects/custom-domain-919ec2c2.gif)

## Step 1: Get a Free Taskade Subdomain

A free subdomain gives you a branded link under **taskade.site**, such as `mycompany.taskade.site`.

1. Open your workspace or app.
2. Open its **App settings**, then go to **Launch** → **Domains**.

![Opening Settings for a workspace or app](https://www.taskade.com/static_images/learn/projects/custom-domain-c8d3bd51.jpg)

![The Domains tab in the left sidebar of Settings](https://www.taskade.com/static_images/learn/projects/custom-domain-50f3d14f.jpg)

3. Next to **Pick your own Taskade subdomain**, click **Pick address**.

![Choosing Taskade Subdomain under Add Domain](https://www.taskade.com/static_images/learn/projects/custom-domain-3ba710be.jpg)

4. In **Choose your address**, type the address that you want, for example "mycompany". It needs 6 to 20 characters: letters, numbers, and hyphens, not at the start or the end.

![Typing a subdomain name](https://www.taskade.com/static_images/learn/projects/custom-domain-b324aeb2.jpg)

5. Click **Set address**. To change an address later, click **Update**.

**What you will see:** The panel shows your new address. Your subdomain also applies to every **public agent** that you share from the workspace. See [Public Agent Inbox](https://www.taskade.com/learn/agents/agent-inbox).

![The subdomain marked as Verified](https://www.taskade.com/static_images/learn/projects/custom-domain-8f7b4d7a.jpg)

## Step 2: Connect Your Own Domain

Use this option for a domain that you already own, such as `app.my-domain.com`. It needs the [Pro plan (up to 10 custom domains), or Business, Max, or Enterprise (unlimited)](https://www.taskade.com/pricing).

1. Open your app **Settings**.

![Opening the app Settings](https://www.taskade.com/static_images/learn/projects/custom-domain-2cd71d51.jpg)

2. Go to the **Domains** tab.

![The Domains tab in the app Settings](https://www.taskade.com/static_images/learn/projects/custom-domain-ef6d41b2.jpg)

3. Next to **Connect a domain you own**, click **Connect**. On a lower plan, a plan badge shows instead.

![Choosing between a Taskade subdomain and your own domain](https://www.taskade.com/static_images/learn/projects/custom-domain-fdd71fe4.jpg)

4. Type your domain. Taskade shows the exact DNS records to add.

![Typing your own domain name](https://www.taskade.com/static_images/learn/projects/custom-domain-a7c50dce.jpg)

![The DNS records that Taskade shows for your domain](https://www.taskade.com/static_images/learn/projects/custom-domain-9a79918a.jpg)

5. Click **Copy all records**, then add the records at your DNS provider. See [Step 3](#step-3-add-the-dns-records-at-your-provider).
6. Go back to Taskade. Taskade checks your DNS records for you and emails you when the domain is connected.

```text
┌──────────────────────────────────────────────────────────────┐
│  Add these records at your domain registrar                  │
├──────────────────────────────────────────────────────────────┤
│  CNAME Record                                                │
│   Host   app                Points to  external.taskade.com  │
│  CNAME Record (SSL Validation)                               │
│   Host   (shown by Taskade) Points to  (shown by Taskade)    │
│  Optional extra check                                        │
│   TXT    (shown by Taskade)                                  │
│                                          [ Copy all records ]│
└──────────────────────────────────────────────────────────────┘
```

**What you will see:** The status moves from **Waiting to go live** to **Configuring SSL certificate**, then to **Your domain is live**. This usually takes a few minutes and can take a few hours.

![A connected custom domain with SSL active](https://www.taskade.com/static_images/learn/projects/custom-domain-ee72bb67.jpg)

## Step 3: Add the DNS Records at Your Provider

Copy each value from the **Domains** panel in Taskade. Do not type the values by hand.

| Record in Taskade | What it does | Do you need it? |
| --- | --- | --- |
| **CNAME Record** | Points your domain at `external.taskade.com` | Yes |
| **CNAME Record (SSL Validation)** | Lets Taskade issue and renew the SSL certificate. Set it once. | Yes |
| **TXT Record (SSL Validation)** | The older SSL record, shown only for some existing domains | Only if Taskade shows it |
| **Optional extra check** (TXT) | An extra ownership check | Only if HTTPS still does not work after about 10 minutes |

For a root domain such as `yourdomain.com` (no `www`), Taskade shows two options. **Recommended:** add an ALIAS, ANAME, or flattened CNAME at the root, if your registrar supports it. **Option 2:** point the domain's nameservers at Cloudflare, then add the record as **DNS only** (grey cloud).

> **Warning:** If you use Cloudflare for DNS, set each Taskade record to **DNS only** (grey cloud). A proxied (orange cloud) record shows visitors "Error 1014" and the site does not load.

### GoDaddy

1. Log in to GoDaddy and go to **My Domains**.
2. Select your domain and click **DNS**.
3. Click **Add Record** and add each record from Taskade. Use the host and the value from the **Domains** panel.
4. Click **Save**. DNS usually updates in 5 to 10 minutes.
5. Go back to the **Domains** panel in Taskade and refresh the status.

### Namecheap

1. Log in, go to **Domain List**, and click **Manage**.
2. Open the **Advanced DNS** tab.
3. Add each record from Taskade. In the **Host** field, type only the subdomain part, for example `app`.
4. Click the check mark icon to save each record.
5. Go back to the **Domains** panel in Taskade and refresh the status.

### DreamHost

1. Log in, go to **Websites**, and click **Manage** for your domain.
2. Click **DNS Settings**.
3. Add each record from Taskade, with the host and the value from the **Domains** panel.
4. Save the records. DNS changes usually take 5 to 30 minutes.
5. Go back to the **Domains** panel in Taskade and refresh the status.

## You Are Done When

The **Domains** panel shows **Your domain is live**, and your app opens at your domain with HTTPS.

## Buy a Domain in Taskade

Taskade can find, buy, and set up a new domain for your app, with no DNS steps. It works on every paid plan, and a domain that you buy does not count toward the custom-domain limit. On Free, **Buy Custom Domain** opens an upgrade prompt.

1. Open your app.
2. In the top-right corner, click the **Publish** drop-down.

![Opening the Publish drop-down in an app](https://www.taskade.com/static_images/learn/projects/custom-domain-f5ceeb4a.jpg)

3. Click **Domains**, then **Buy Custom Domain**.

![Clicking Buy Domain in the Domains menu](https://www.taskade.com/static_images/learn/projects/custom-domain-c1156cc2.jpg)

4. Type a few words for your domain, then click **Search**.

![Searching for an available domain name](https://www.taskade.com/static_images/learn/projects/custom-domain-2284161b.jpg)

5. Click **Add** next to the domain that you want, then click **Buy & Publish**.

![Selecting a domain and clicking Buy & Publish](https://www.taskade.com/static_images/learn/projects/custom-domain-095a0bf3.jpg)

6. Follow the steps on the screen to finish the purchase.

Taskade sets up the DNS records and the SSL certificate for a domain that you buy. The domain renews each year, and you can turn auto-renew off in the **Domains** panel.

## Troubleshooting

Find what you see in the left column, then do the fix.

| What you see | Why | Fix |
| --- | --- | --- |
| "Request HOST is not whitelisted" | You typed a path that the domain does not serve | Open the published link from the app or the **Domains** panel. |
| "custom hostname does not CNAME to this zone" | The CNAME record does not point at Taskade yet | Make sure that the CNAME points at `external.taskade.com`, then wait. DNS changes can take up to 48 hours. |
| "Your SSL validation record is a TXT: it must be a CNAME" | The SSL record was added as TXT | Delete the TXT record, then add it again as a CNAME with the **SSL Validation** values. |
| Visitors see "Error 1014" | The record is proxied in Cloudflare (orange cloud) | Set the record to **DNS only** (grey cloud). |
| "SSL validation timed out or expired" | The records were missing for too long | Make sure that the records are still in place, then click **Refresh**. |
| A message says that you used all the custom domains in your plan | On Pro, the workspace and its subspaces connected 10 domains | Remove a domain that you no longer use, buy the new domain in Taskade, or move to Business for unlimited custom domains. |

## Tips

- **Keep your brand the same everywhere.** Every public Taskade link carries your domain.
- **Look professional to clients.** Share public agents and apps on an address that is easy to remember.
- **Promote your work.** Use a custom or free subdomain in marketing campaigns.
- **Polish your proposals.** Put branded links in client proposals and presentations.

## Frequently Asked Questions

**How do I fix the "Request HOST is not whitelisted" error?**

A domain serves only its supported public links. For example, if `mymarketing.taskade.site` is your subdomain, only public links like `mymarketing.taskade.site/a/123456abc123` resolve. Open the published link from the app or the **Domains** panel rather than typing a path by hand.

**How do I fix the "custom hostname does not CNAME to this zone" error?**

The CNAME record at your domain provider does not point at Taskade yet, so no certificate exists. Make sure that the CNAME points at `external.taskade.com` with no typos. Then wait, because DNS changes can take up to 48 hours.

**Which plan do I need for a custom domain?**

Custom domains are on the **Pro, Business, Max, and Enterprise** plans. Pro includes up to 10 custom domains, and Business and above include unlimited custom domains. Free and Starter do not include them. A free `taskade.site` or `taskade.app` address works on every plan.

**Can I use a root domain, or only a subdomain?**

Both. A subdomain like `app.yourdomain.com` uses a CNAME that points at `external.taskade.com`. A root domain like `yourdomain.com` uses an ALIAS, ANAME, or flattened CNAME at the root, or nameservers at Cloudflare. Taskade shows the right records when you type the domain.

**Does Taskade add the SSL certificate for me?**

Yes. After your DNS records resolve, Taskade issues the SSL certificate and renews it for you. Keep the **CNAME Record (SSL Validation)** in place so that renewals keep working.

## Next Steps

Publish first, then brand and protect what you share.

1. **Publish your app**: See [Custom Domains for Your Apps](https://www.taskade.com/learn/genesis/custom-domains) and the [Taskade Genesis FAQ](https://www.taskade.com/learn/genesis/faq).
2. **Publish a project**: See [Publish a Project](https://www.taskade.com/learn/projects/publishing).
3. **Share with people**: See [Share a Project](https://www.taskade.com/learn/projects/share-project).
4. **Embed your work**: See [Embed Taskade](https://www.taskade.com/learn/projects/embed-taskade).
5. **Protect a link**: Add a password with [Share with Password](https://www.taskade.com/learn/projects/password-share).
