How to connect your own domain
Want visitors to see yourbusiness.com instead of yoursite.playcode.io? This guide walks you through it step by step. No technical knowledge needed - just follow along.
Before you start: You need a Pro account and a published project. Custom domains are a Pro feature.
The big picture (30 seconds)
You own a domain name (like yourbusiness.com) from a company like GoDaddy, Namecheap, or Cloudflare. Right now it probably points nowhere or to an old site. You are going to change one setting so it points to PlayCode instead. That's it. After that, anyone who types your domain sees your PlayCode website.
The whole process takes about 10 minutes of your time.
Where to buy a domain (if you don't have one yet)
We recommend Cloudflare Registrar. It is the easiest option for PlayCode users:
- Cheapest prices - Cloudflare sells domains at cost, no markup
- CNAME flattening - works perfectly with root domains (more on this below)
- Simple DNS management - everything in one place
- No upsells - just a clean, reliable service
Other popular options: Namecheap, Google Domains, GoDaddy. They all work with PlayCode, but Cloudflare makes the DNS setup easiest.
Step 1: Set up DNS (do this first)
Go to your domain provider's website (where you bought the domain) and find the DNS settings. You need to add one record that tells the internet "this domain should go to PlayCode."
Important: Do this step BEFORE adding the domain in PlayCode. It makes everything go smoother.
Option A: CNAME record (recommended)
This is the best option. Use it if your domain provider supports it.
| Setting | What to enter |
|---|---|
| Type | CNAME |
| Name | @ for root domain (yourbusiness.com)www for www.yourbusiness.com |
| Target | app.playcode.io |
About root domains and CNAME: Technically, the DNS standard does not allow CNAME records on root domains (yourbusiness.com without www). However, Cloudflare supports this through a feature called "CNAME flattening" - it just works. Most other providers (GoDaddy, Namecheap) do not support CNAME on root domains. If your provider does not support it, use Option B below. Option B: A record (if CNAME doesn't work for root domain)
If your domain provider does not allow CNAME on the root domain, use an A record instead. This points your domain directly to our server's IP address.
| Setting | What to enter |
|---|---|
| Type | A |
| Name | @ |
| Value | 88.198.232.54 |
Note about A records: A records point to a specific IP address. If we ever need to change our server IP in the future, you would need to update this record. CNAME (Option A) does not have this problem because it points to a name, not an IP. This is why CNAME is always preferred when your provider supports it.
Tip: If you are using GoDaddy or Namecheap and want to use your root domain, the easiest solution is to transfer your domain to Cloudflare (it is simple and usually takes a few minutes). Then you can use CNAME for everything.
Provider-specific instructions
Cloudflare (recommended)
- Log in to Cloudflare and select your domain
- Go to DNS > Records
- Click Add record
- Select Type: CNAME
- Name: Enter
@(for root) orwww - Target: Enter
app.playcode.io - Proxy status: Click the orange cloud to turn it gray (DNS only)
- Click Save
Very important: The cloud icon must be gray (DNS only), not orange. If the proxy is on, your SSL certificate will not work.
GoDaddy
- Log in to GoDaddy > My Products
- Click DNS next to your domain
- Click Add
- For
wwwsubdomain: Type = CNAME, Name =www, Value =app.playcode.io - For root domain: Type = A, Name =
@, Value =88.198.232.54 - Click Save
GoDaddy does not support CNAME on root domains. Use an A record for the root, or transfer your domain to Cloudflare for the best experience.
Namecheap
- Log in to Namecheap > Domain List > Manage
- Go to Advanced DNS tab
- Click Add New Record
- For
wwwsubdomain: Type = CNAME, Host =www, Value =app.playcode.io - For root domain: Type = A, Host =
@, Value =88.198.232.54 - Click the green checkmark to save
Namecheap does not support CNAME on root domains. Use an A record for the root, or transfer your domain to Cloudflare.
Step 2: Add domain in PlayCode
Wait 5-10 minutes after changing DNS, then:
- Open your project in PlayCode
- Click Publish in the top right corner
- Scroll down to Custom Domains
- Click Add custom domain
- Type your domain name exactly as you set it up:
yourbusiness.com- if you configured the root domainwww.yourbusiness.com- if you configured the www subdomain
- Click Add
Common mistake: Only enter the domain name. Do not enter your project name, and do not addhttps://in front.
- Correct:
yourbusiness.com- Wrong:
https://yourbusiness.com- Wrong:
my-project-name
Step 3: Wait for SSL (automatic)
After adding your domain, PlayCode does two things automatically:
- HTTP access - your site works immediately at
http://yourbusiness.com - SSL certificate - HTTPS is generated automatically. This usually takes 1-2 hours (sometimes up to 24 hours). No action needed from you.
Once SSL is ready, your site works securely at https://yourbusiness.com.
Something not working?
Site not loading at all
- DNS changes can take up to 30 minutes to spread. Wait and try again.
- Double-check that your DNS record points to
app.playcode.io(CNAME) or88.198.232.54(A record). - Make sure you entered the domain correctly in PlayCode (no typos, no
https://).
HTTPS not working after 2+ hours
- Cloudflare users: Make sure the proxy is OFF (gray cloud, not orange).
- Check that HTTP works first (
http://yourbusiness.com). SSL is generated after HTTP works. - If you are using an A record, try switching to CNAME (may require Cloudflare).
"Domain not valid" error
- Enter just the domain:
yourbusiness.comorwww.yourbusiness.com - Do not enter your project name, random words, or URLs with
https://
Quick summary
| Your situation | What to do |
|---|---|
| Domain on Cloudflare | CNAME @ or www > app.playcode.io (proxy off) |
www subdomain (any provider) | CNAME www > app.playcode.io |
| Root domain on GoDaddy/Namecheap/other | A record @ > 88.198.232.54 |
Still stuck? Chat with us using the chat button in the bottom right corner. We'll help you get your domain connected.
Related Articles
Need more help?
Can't find what you're looking for? Chat with us or send us an email.