Skip to main content
PlainRouter collects Signals through a subdomain you control, such as collect.example.com. Connecting this collection domain requires one CNAME record. The change applies only to the collection subdomain. It does not move your website, email, or root domain to PlainRouter.

​
How the CNAME works

Add the CNAME exactly as shown in PlainRouter. The name and value displayed in your setup are specific to your collection domain.
You do not need to create a Cloudflare Worker Route or configure application routing. PlainRouter registers the collection hostname automatically after DNS and HTTPS validation succeeds.

​
Before you begin

You need:
  • Access to the DNS provider that manages your website domain.
  • Permission to add a CNAME record.
  • A collection subdomain that is not already used by another service.
You can identify the active DNS provider by checking where your domain’s nameservers are managed. This may be different from the company where you registered the domain.

​
Add the CNAME record

1

Open the DNS configuration

In PlainRouter, open Signals and continue setup.After you enter your collection domain, PlainRouter displays the exact Type, Name, and Value for the required CNAME.
2

Add the CNAME record

In your DNS provider, create the CNAME using the collection domain as its name and the PlainRouter target as its value.Enter only the hostname in the value field. Do not include https://, a path, or a trailing slash.
3

Save and validate

Save the CNAME and return to PlainRouter.CNAME changes are typically detected within five minutes. Cloudflare then validates ownership and provisions HTTPS automatically. If setup remains pending after five minutes, click Retry validation.

​
Match your provider’s fields

DNS providers use different labels for the same fields: Some providers automatically append your root domain to the Name field. If entering collect.example.com produces collect.example.com.example.com, enter only the host portion, such as collect.
Use the copy buttons beside the CNAME name and value in PlainRouter. This avoids typing mistakes.

​
Confirm activation

PlainRouter validates ownership and HTTPS automatically after the CNAME points to PlainRouter. Keep the setup screen open, or return later through Signals. When validation succeeds, PlainRouter moves setup to Verify server-side ingestion. Keep the CNAME in place after activation.

​
Troubleshoot validation

​
The CNAME does not validate

  • Remove any existing A, AAAA, or CNAME record using the same collection hostname. A hostname cannot point to multiple services at once.
  • Confirm the CNAME value contains only the target hostname shown in PlainRouter.
  • Check that you edited the DNS zone used by your domain’s active nameservers.
  • If your DNS provider adds the root domain automatically, make sure the record name is not duplicated.

​
HTTPS validation fails

HTTPS becomes available after the collection hostname points to PlainRouter and Cloudflare completes automatic validation. If PlainRouter reports a CAA conflict, review the CAA records on your domain and allow the certificate authority named in the validation error. If you do not manage those restrictions, ask your DNS administrator to update them.

​
Setup is still pending

DNS updates can take longer than the provider’s dashboard suggests. Leave the CNAME in place and retry after several minutes. Changing the value repeatedly restarts the validation process.

​
Next step

After the collection domain becomes active, verify Signal ingestion. You can install the optional browser pixel afterward.