CUSTOM DOMAINS · PRO
Your domain, step by step.
Use an address like qr.yourbusiness.com in your QR codes. Your main website and email can stay exactly where they are.
Before you begin
- You must own the domain and have permission to edit its DNS records.
- Use a dedicated subdomain such as
qrorgo. Do not replace an existing website hostname. - Domain purchase and renewal are separate from your OpticQR subscription.
Connect a subdomain
- Save the hostname. Sign in to OpticQR, open Domains, and enter
qr.yourbusiness.com. Enter no path. This saves a request; it does not buy or activate the domain. - Prepare the connection. If automatic setup is available, choose Connect. Otherwise copy the setup request and send it to your OpticQR operator. The operator prepares the connection and returns the exact records.
- Find your DNS provider. Open the service that manages your domain’s nameservers. This may be different from the company where you bought the domain. Find DNS, Manage DNS, or DNS Records.
- Add the CNAME record. Copy its name and target from OpticQR. Some providers want only
qrin the name field; others want the full hostname. Check the resulting record does not repeat your domain twice. Use the default TTL. Do not paste a URL or addhttps://to the target. - Add every verification record. Copy the TXT record names and values exactly. There may be separate records for domain ownership and the HTTPS certificate. Do not delete unrelated TXT or email records.
- Check the connection. Choose Verify DNS & HTTPS if available. In operator-assisted mode, ask the operator to verify, then refresh the saved status. DNS changes may take minutes or longer depending on your provider and cached records.
- Wait for Connected. Both hostname ownership and the HTTPS certificate must be active. Saving a name or seeing a DNS record is not enough.
- Select the default and test. Choose your connected hostname as the default for new codes. Create a new QR code, scan it on a phone, confirm the destination, and check its report before printing.
Where to find DNS settings
Provider menus change; their official instructions are the best reference.
- Cloudflare: create DNS records. Follow the connection’s required proxy setting; a DNS-only customer CNAME is the usual starting configuration for a SaaS hostname.
- GoDaddy: add a CNAME. DNS management usually separates the Name and Value fields.
- Namecheap: add a CNAME. Look under Advanced DNS when Namecheap manages the DNS.
Troubleshooting
- Record already exists: another record may occupy the same name. Choose a fresh subdomain if you are unsure what the existing record supports.
- Still pending: compare every name and value, verify the authoritative DNS provider, and allow existing TTLs to expire before retrying.
- Ownership verified, HTTPS pending: inspect certificate verification records. Restrictive CAA records can also prevent issuance; ask your DNS administrator or the operator to review the provider’s error.
- Connected but wrong destination: check the individual code’s saved destination and its schedule. DNS setup does not change campaign destinations.
- Root domain requested: start with a subdomain. Root-domain routing depends on provider capabilities and should be handled by the operator.
Protect codes you have already printed
A QR image permanently contains its scan address. Changing your default affects only newly created codes. Keep old domains registered and connected for as long as printed codes use them. You can change a destination without changing the scan address.
Google sign-in and the dashboard remain at the OpticQR app address. You do not need to configure Google login on every scan domain.
Moving providers
Keep a list of your scan paths and destinations. Before changing DNS, make sure the new service resolves the same paths and has a working certificate. Changing providers without preserving those paths can break printed codes.