Troubleshooting
Solutions for common problems during subdomain registration.
CI Failures
Your PR's CI check failed — here's how to read the error and push a fix.
DNS Propagation
Your PR was merged but the subdomain isn't resolving yet.
Common Errors
Validation errors from the CLI validator and how to fix each one.
How to read a CI failure
When CI fails on your PR, GitHub automatically posts a comment with the error. Look for a comment from the github-actions bot — it will contain the exact validation error.
The two most common CI failures are:
- Schema validation failed — your JSON file has a formatting or value error
owner.githubmismatch — the GitHub username in your JSON doesn't match the account that opened the PR
See CI Failures for fixes for both.