Use more than one domain in your workspace

One workspace can hold several domains at once: one per brand, one per country, or an old one kept alive for links already in circulation. This page covers which one is used by default, and how to keep the list from becoming noise.

Availability

Plan: Starter 1 domain, Pro 5, Business 10, Advanced 50, Enterprise 1000. The Free plan holds none.
Where: Domains in the sidebar.

Before you start

Every domain needs its own DNS record, so the second domain is the same work as the first — see Point your domain with a CNAME or A record.

Set the primary domain

The domain marked Primary Domain is preselected in Short Link whenever someone creates a link or a QR code, which is why it matters more than it looks: it decides what the whole team ships by default.

Open Domains and select Edit on the domain.
Open Advanced Options and turn on Primary Domain.
Select Save changes.

The Short Link field in the link builder, with the custom domain preselected

Only one domain is primary at a time; marking a new one moves the mark.

Pick a different domain for one link

In the link or QR code builder, open the domain dropdown at the left of Short Link and choose from the list. It contains every domain in the workspace plus the CodeQR shared domains. The choice belongs to that link alone and does not change the default.

Archive a domain you no longer use

Archived hides a domain from the everyday lists while leaving it fully operational: existing links on it keep resolving, and their statistics keep accumulating. It is the setting to reach for when a campaign domain is done but its links are still printed on something.

Domains → Edit → Advanced Options.
Turn on Archived and select Save changes.

Archiving is not deleting, and the difference is severe — see Change or remove a domain without losing links.

Give your team a hint with Placeholder URL

Placeholder URL sets the example address shown in the link builder's Destination URL field for that domain. On a domain used by one team for one product, filling it with a typical destination is a quiet way to indicate what belongs there. It is visible only inside CodeQR and changes nothing about the link.

What happens when you exceed the limit

Adding a domain beyond your plan's allowance is refused. Downgrading a plan does not delete the domains you already have — they stay, along with their links.

Do the same with the API

Not available. The domain endpoints in the API reference return a 404, so the domain list, the primary flag and the archived flag cannot be read or set from a script today.

Links and QR codes, on the other hand, take the domain as a normal field:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/es","domain":"go.example.com","key":"verano"}'

Verify it works

Create a link without touching the domain dropdown and confirm the short link uses the domain you marked as primary. Then check that a link on the archived domain still resolves:

curl -sSI https://old.example.com/campaign

HTTP/2 302
location: https://example.com/campaign

Troubleshooting

The new domain is not offered in the link builder

Reload the builder. A domain that is still Pending Verification is offered, but links created on it will not resolve until DNS is in place.

Two domains are both marked primary

Not possible — setting one clears the other. If the list looks wrong, reload the Domains page.

An archived domain disappeared from my dashboard

That is what Archived does. Its links continue to work; turn the switch off to bring it back into view.

I hit my domain limit and need one more

Free the slot by removing a domain you truly no longer need — read Change or remove a domain without losing links first, because removal is destructive — or move to a plan with a higher allowance.