Background:
When adding a hostname/domain to a Wijmo license (e.g., while generating a Distribution Key), the portal validates the text you enter. If the entry doesn’t match accepted hostname rules, you may see an error like:
“The hostname 111.hostname.tld is not in a valid format.”
This article explains common reasons the portal rejects a domain and how to fix them.
Steps to Complete:
- Check for formatting issues
- Avoid patterns the validator blocks
- Try a DNS alias if the label is numeric-only
- Re-submit the cleaned hostname
- Still blocked? Contact support
Getting Started:
Check for formatting issues
- Try to enter only the hostname (no http://, https://, paths, ports, or query strings).
- Remove leading/trailing spaces, quotes, or hidden characters.
- Ensure labels are 1-63 characters use only a-z, 0-9, -, and don't start/end with -.
- Avoid underscores (_) and double dots (..)
Avoid patterns the validator blocks
- It's possible our validator may reject numeric-only labels (e.g., 111 in 111.domain.tld) to prevent confusion with IP addresses.
Try a DNS alias if the label is numeric-only
-
Create a CNAME such as w111.domain.tld → 111.domain.tld, then add w111.domain.tld in the portal.
- Alternatively, rename the subdomain (e.g., app-111.domain.tld).
Re-submit the cleaned hostname
-
After correcting the value, add it again in the portal.
Still blocked? Contact support
-
Reach out to Mescius support. We can manually add domains (including special cases like numeric-only labels or required wildcards).
Hope you find this article helpful. Happy coding!

Andrew Peterson
Technical Engagement Engineer