Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.streampixel.io/llms.txt

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

Replace the default share.streampixel.io URL with one of your own — play.yourgame.com, demo.yourcompany.com. Useful for branding, same-origin embedding (no third-party cookie issues), and tight Content Security Policies.

​
Add a custom domain

1

Open Project Settings

Navigate to the project that should serve from a custom domain and open Project Settings.
2

Open the Custom Domains tab

Click Custom Domains.
3

Enter your domain

Type the full domain or subdomain you want to use, e.g. play.example.com. Submit.
4

Add the DNS record

Streampixel shows a CNAME (or A record for apex domains) value. Copy it and add it at your DNS provider — Cloudflare, Route 53, GoDaddy, Namecheap, etc.
5

Click Verify

Once the DNS record is live, click Verify in the dashboard. Streampixel checks resolution and provisions HTTPS.
6

Wait for propagation

Verification can take a few minutes. Once it succeeds, the domain shows as Active and the stream is reachable.
Custom domain settings

​
DNS setup

Use a CNAME for subdomains (recommended) and an A record for apex domains.
Record typeWhen to useExample
CNAMESubdomains like play.example.complay.example.com → cname.streampixel.io
AApex domains like example.com (some registrars do not allow CNAME at the apex)example.com → 203.0.113.10
The exact target value is shown in the dashboard — always copy it from there rather than guessing.
DNS changes can take a few minutes to several hours to propagate globally, depending on your provider’s TTL and your registrar. If verification fails immediately after adding the record, wait 5-10 minutes and try again.

​
HTTPS / TLS

Streampixel handles certificate provisioning automatically as soon as DNS verification succeeds. There is no need to upload a certificate, generate a CSR, or renew anything. Certificates are renewed before expiry without any action on your side. The stream is only served over HTTPS — there is no HTTP fallback.
If your DNS provider has CAA records, make sure they permit Streampixel’s certificate authority. Most defaults are permissive enough; if certificate issuance fails, removing the CAA record temporarily is the easiest fix.

​
Multiple domains per project

Click Add another to attach more than one domain — useful for migrations, regional variants (play.example.com + play.example.de), or apex + www.

​
Remove a domain

1

Open the Custom Domains tab

Find the domain you want to remove.
2

Click Remove

Confirm in the dialog.
3

Clean up DNS

Delete the CNAME or A record at your DNS provider so the hostname no longer points at Streampixel.
Removing a domain takes effect immediately. Any embed or share link using that domain will break the moment you confirm.

​
Troubleshooting

ProblemCauseFix
Verification failsDNS record not propagated yetWait 5-10 minutes, then click Verify again.
Verification failsDNS record points at the wrong targetRe-copy the exact value shown in the dashboard.
Verification failsA pre-existing record is still cachedLower the TTL on your DNS, wait, then retry.
HTTPS shows a warningCertificate is still provisioningWait a minute or two after a successful verification.
Stream loads on the streampixel.io URL but not the custom domainDNS resolves but is pointed at the wrong hostUse dig +short play.example.com to confirm it resolves to the value the dashboard expects.
Embedding still shows third-party cookie warningsBrowser is caching the old originHard-refresh the embedding page after switching the embed URL to the custom domain.
Use dig, nslookup, or dnschecker.org to verify DNS propagation across regions before clicking Verify.

​
Next

Share & embed

Use your custom domain in iframes.

Security & access

Whitelist your domain alongside share.streampixel.io.