Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pageo.me/llms.txt

Use this file to discover all available pages before exploring further.

Connect your own domain to your Pageo profile so your link-in-bio lives at a URL you own (e.g. links.yourname.com or yourname.com). Pageo handles verification and routing—you add a couple of DNS records and we do the rest.

​
Overview

With custom domains you can:
  • Use your own domain or subdomain for your Pageo profile
  • Keep your brand in the URL (e.g. links.yourcompany.com)
  • Rely on automatic verification—we check every few seconds once you add the records
  • Remove or change the domain anytime from the admin

​
Prerequisites

Before you begin, make sure you have:
  • A Pageo account (free or Pro)
  • Access to your domain’s DNS settings at your registrar or DNS provider (e.g. Cloudflare, Namecheap, GoDaddy, Vercel)
  • Your domain or subdomain in mind (e.g. example.com or links.example.com)

​
Supported Setups

  • Root/apex domain: yourdomain.com → you’ll add an A record and a TXT record.
  • Subdomain: links.yourdomain.com, bio.yourdomain.com, etc. → you’ll add a CNAME record and a TXT record.

​
Step 1: Add Your Domain in Pageo

  1. Log in to your Pageo account and open the admin dashboard.
  2. Open Custom Domains (or the domain settings section).
  3. Enter your domain (e.g. links.example.com or example.com).
  4. Click Add Domain.
Pageo will reserve the domain and generate a verification token and the routing record you’ll add in DNS.

​
Step 2: Add DNS Records at Your Provider

You’ll add two records at the place where your domain’s DNS is managed (registrar, Cloudflare, Vercel, etc.):
  1. Verification record (TXT)
    Proves you control the domain. Pageo shows:
    • Type: TXT
    • Host: (shown in the modal—e.g. _pageo-verification for root, or _pageo-verification.links for links.example.com)
    • Value: the long token Pageo gives you (copy from the modal)
  2. Routing record (A or CNAME)
    Sends traffic to Pageo:
    • Root domain (example.com):
      • Type: A
      • Host: @ (or leave blank if your provider uses “root”)
      • Value: the IP address shown in Pageo (e.g. 216.198.79.1)
    • Subdomain (e.g. links.example.com):
      • Type: CNAME
      • Host: the subdomain only (e.g. links)
      • Value: cname.pageo.me

​
Tips

  • Copy the Value from Pageo with the copy button to avoid typos.
  • If your provider has a TTL setting, default (e.g. 300–3600) is fine.
  • Some providers use “Name” or “Host” instead of “Host”; use exactly what Pageo shows for that record.

​
Step 3: Wait for Verification

  • Pageo checks automatically every few seconds while the Custom Domains modal is open. You don’t need to click “Verify” repeatedly.
  • DNS changes can take a few minutes to an hour to propagate. If it’s not verified right away, leave the modal open or come back later and open it again.
  • When verification succeeds, you’ll see a success state and your profile will be available on your custom domain.
You can also click Verify Domain once you’ve added the records if you want to trigger a check immediately.

​
Step 4: Visit Your Profile

Once verified:
  • Open https://<your-domain> (or https://<subdomain>.<your-domain>) in a browser.
  • Your Pageo profile will load on your custom URL.
  • Your default pageo.me/username URL continues to work as well.

​
Removing or Changing Your Domain

  • To remove the custom domain: open Custom Domains in the admin and use Remove Domain. Confirm when prompted. The modal will close after the removal finishes.
  • To use a different domain: remove the current one, then add the new domain and repeat the DNS steps above.
Removing the domain only disconnects it from Pageo. It does not delete the DNS records at your provider. You can remove or change those in your DNS dashboard if you no longer want the domain to point to Pageo.

​
Troubleshooting

​
Verification never succeeds

  • Wait longer: Propagation can take 5–30 minutes (sometimes more).
  • Check the records: Host and value must match exactly what Pageo shows (no extra spaces, correct subdomain for TXT host).
  • Root vs subdomain: For example.com use the root/apex instructions; for links.example.com use the subdomain (CNAME) instructions.
  • Try Verify Domain manually after waiting a few minutes.

​
”Verification failed” or “Domain verification failed”

  • Confirm the TXT record’s value is the full token from Pageo and the host matches (e.g. _pageo-verification for root).
  • Confirm the A or CNAME record points to the correct target (IP or cname.pageo.me).
  • Use a DNS lookup tool (e.g. DNS checker) to see what the rest of the internet sees for your domain.

​
Site doesn’t load or shows wrong page

  • Give it a few minutes after verification; SSL and routing can take a short time to activate.
  • Clear cache or try an incognito window.
  • Ensure you’re visiting https:// and the exact host you added (e.g. links.example.com).

​
CNAME for root domain

  • Some providers don’t allow CNAME on the root. Pageo’s flow uses an A record for root domains; use the A record and IP shown in the admin. If your provider only supports CNAME at root (e.g. CNAME flattening), their docs will describe how that maps to an A target; use the IP Pageo gives you as the target if possible.

​
Summary

  1. Add your domain in Pageo (admin → Custom Domains).
  2. Add the TXT (verification) and A or CNAME (routing) records at your DNS provider.
  3. Wait for automatic verification (or use Verify Domain); propagation usually takes 5–10 minutes.
  4. Visit your custom URL to confirm your profile loads.
For more on DNS and your specific provider, check their documentation. For product updates, see the changelog.