283

Can subdomains (domain names) have underscore _ in them?

2
  • 16
    I have taken your question litterally: that you really meant DOMAIN NAMES. If,instead, you meant HOST NAMES, edit your question, because the answer will be different.
    – bortzmeyer
    Commented Feb 2, 2010 at 12:52
  • 3
    "domain name" is an ambiguous term. What it means vary when used in a DNS settings vs when viewed in a "registration" setting, aka when you are about to register a given name. You can't register a domain name with an underscore because in the registration plane a domain name is in fact more an hostname in the DNS terminology and hence more restrictive in allowed characters (but then there are IDNs that allow characters outside of ASCII...). As a domain name in the DNS sense of it, any character is allowed. Commented Feb 17, 2022 at 15:10

12 Answers 12

475

Most answers given here are false. It is perfectly legal to have an underscore in a domain name. Let me quote the standard, RFC 2181, section 11, "Name syntax":

The DNS itself places only one restriction on the particular labels that can be used to identify resource records. That one restriction relates to the length of the label and the full name. [...] Implementations of the DNS protocols must not place any restrictions on the labels that can be used. In particular, DNS servers must not refuse to serve a zone because it contains labels that might not be acceptable to some DNS client programs.

See also the original DNS specification, RFC 1034, section 3.5 "Preferred name syntax" but read it carefully.

Domains with underscores are very common in the wild. Check _jabber._tcp.gmail.com or _sip._udp.apnic.net.

Other RFC mentioned here deal with different things. The original question was for domain names. If the question is for host names (or for URLs, which include a host name), then this is different, the relevant standard is RFC 1123, section 2.1 "Host Names and Numbers" which limits host names to letters-digits-hyphen.

14
  • 122
    +1 for the difference between "domain names" and "host names"
    – Alnitak
    Commented Feb 2, 2010 at 10:03
  • 4
    The question (unless it was edited) is about subdomains ie. hostnames. You're not wrong about your factual statements, except pointing out that answers are false, based on how the question is currently worded.
    – redreinard
    Commented Apr 11, 2014 at 2:36
  • 8
    I'm confused, 1034 says "The labels must follow the rules for ARPANET host names. They must start with a letter, end with a letter or digit, and have as interior characters only letters, digits, and hyphen." Which part of that allows an underscore? Commented Sep 16, 2016 at 19:01
  • 4
    The wording is confusing. URLs can't have underscores. A URL is always a FQDN, it's not a host name. A FQDN can have an empty host name, in this case FQDN = domain. _jabber._tcp.gmail.com is not a domain, it's a FQDN. Because URLs can't have underscore in them, you'll probably never be able to buy a domain with an underscore in it. So, even tho domains could also have underscores from a DNS syntax point of view, you will never encounter any, unless it's a local one.
    – Capsule
    Commented Mar 17, 2017 at 1:11
  • 2
    I can't see the quote in 2.1 of rfc1123 that mentions anything about hyphens being allowed. I can see in the rfc952 that a name can be <let-or-digit-or-hyphen>. Is that what you were referring to?
    – AJP
    Commented Apr 2, 2017 at 15:59
119

A note on terminology, in furtherance to Bortzmeyer's answer

One should be clear about definitions. As used here:

  • domain name is the identifier of a resource in a DNS database
  • label is the part of a domain name in between dots
  • hostname is a special type of domain name which identifies Internet hosts

The hostname is subject to the restrictions of RFC 952 and the slight relaxation of RFC 1123

RFC 2181 makes clear that there is a difference between a domain name and a hostname:

...[the fact that] any binary label can have an MX record does not imply that any binary name can be used as the host part of an e-mail address...

So underscores in hostnames are a no-no, underscores in domain names are a-ok.

In practice, one may well see hostnames with underscores. As the Robustness Principle says: "Be conservative in what you send, liberal in what you accept".

A note on encoding

In the 21st century, it turns out that hostnames as well as domain names may be internationalized! This means resorting to encodings in case of labels that contain characters that are outside the allowed set.

In particular, it allows one to encode the _ in hostnames (Update 2017-07: This is doubtful, see comments. The _ still cannot be used in hostnames. Indeed, it cannot even be used in internationalized labels.)

The first RFC for internationalization was RFC 3490 of March 2003, "Internationalizing Domain Names in Applications (IDNA)". Today, we have:

  • RFC 5890 "IDNA: Definitions and Document Framework"
  • RFC 5891 "IDNA: Protocol"
  • RFC 5892 "The Unicode Code Points and IDNA"
  • RFC 5893 "Right-to-Left Scripts for IDNA"
  • RFC 5894 "IDNA: Background, Explanation, and Rationale"
  • RFC 5895 "Mapping Characters for IDNA 2008"

You may also want to check the Wikipedia Entry

RFC 5890 introduces the term LDH (Letter-Digit-Hypen) label for labels used in hostnames and says:

This is the classical label form used, albeit with some additional restrictions, in hostnames (RFC 952). Its syntax is identical to that described as the "preferred name syntax" in Section 3.5 of RFC 1034 as modified by RFC 1123. Briefly, it is a string consisting of ASCII letters, digits, and the hyphen with the further restriction that the hyphen cannot appear at the beginning or end of the string. Like all DNS labels, its total length must not exceed 63 octets.

Going back to simpler times, this Internet draft is an early proposal for hostname internationalization. Hostnames with international characters may be encoded using, for example, 'RACE' encoding.

The author of the 'RACE encoding' proposal notes:

According to RFC 1035, host parts must be case-insensitive, start and end with a letter or digit, and contain only letters, digits, and the hyphen character ("-"). This, of course, excludes any internationalized characters, as well as many other characters in the ASCII character repertoire. Further, domain name parts must be 63 octets or shorter in length.... All post-converted name parts that contain internationalized characters begin with the string "bq--". (...) The string "bq--" was chosen because it is extremely unlikely to exist in host parts before this specification was produced.

8
  • 1
    On a side note, "Systems such as DomainKeys and service records use the underscore as a means to assure that their special character is not confused with hostnames. For example, _http._sctp.www.example.com specifies a service pointer for an SCTP capable webserver host (www) in the domain example.com." (link)
    – x-yuri
    Commented Jul 20, 2015 at 17:22
  • 2
    @Nelda.techspiress It's been some time but according to RFC 1034: Domain Names - Concepts and Facilities, what is called a "subdomain" of a domain bar.baz. (for example) is just the collection of domain names that are hierarchically underneath bar.baz., e.g. a.bar.baz., f.g.bar.baz., h.bar.baz., etc. This "subdomain" may or may not include actual hostnames. Commented Jun 6, 2017 at 19:42
  • 2
    In daily usage, one may tend to incorrectly call the string a.bar.baz (a domain name) "a subdomain of" the string bar.baz (another domain name). The domain names (DNS database resources) a.bar.baz and bar.baz may or may not be hostnames. Commented Jun 6, 2017 at 19:42
  • 1
    On page 8 of RFC 1034, we read: A domain is identified by a domain name, and consists of that part of the domain name space that is at or below the domain name which specifies the domain. A domain is a subdomain of another domain if it is contained within that domain. This relationship can be tested by seeing if the subdomain's name ends with the containing domain's name. For example, A.B.C.D is a subdomain of B.C.D, C.D, D, and " ". Commented Jun 6, 2017 at 19:43
  • 1
    RFC 5892 "The Unicode Code Points and IDNA" does NOT list _ (U+005F) as an allowed code point. Not sure why @DavidTonhofer claims that it does. Commented Jul 6, 2017 at 23:04
52

There is one additional thing you may need to know: If the host or subdomain part of the url contain an underscore, IE9 (have not tested other versions) cannot write cookies.

So be careful about that. :-)

10
16

Clarifying bortzmeyer and David Tonhofer, domain name and subdomain name labels can contain leading underscores, but nowhere else.

As David Tonhofer wrote, labels are the in-between-the-periods parts and should follow the LDH rule except when specifying service labels and port labels to differentiate them from regular labels. Then they must occur at the beginning of the label which should be the "Short Names" from the Service Name and Port Number Registry, the port number with no leading 0s, or the protocol (ie. tcp, udp). These service labels are further limited to 15 characters.

  • RFC2782 specifies prefixing service record subdomains with underscores.
  • RFC6698 specifies prefixing port numbers with underscores in TLSA certificate records.

Contrary to David Tonhofer's answer, IDN does not allows for encoding underscore ('_' U+005F LOW LINE) or any other invalid ASCII character.

From RFC5890

[..] two new subsets of LDH labels are created by the introduction of IDNA. These are called Reserved LDH labels (R-LDH labels) and Non-Reserved LDH labels (NR-LDH labels). Reserved LDH labels, known as "tagged domain names" in some other contexts, have the property that they contain "--" in the third and fourth characters but which otherwise conform to LDH label rules.

Punycode encodes all ASCII codepoints as ASCII directly, including underscore. The resulting R-LDH would not conform the the LDH label rules. For example, Σ_.com would be encoded as xn--_-zmb.com which violates the rules. There may be a homographic codepoint which looks like an underscore that can be coded legally (perhaps '_' U+FF3F fullwidth low line), but these kinds of codepoints would be categorized as DISALLOWED by RFC5892 under 2.3 IgnorableProperties as a Noncharacter_Code_Point.

RACE (the other proposed IDN encoding scheme) was not accepted as a standard by IETF and should not be used.

2
  • 2
    Finally. Can't believe this is the only post in the whole page that even talks about punycode.
    – Pacerier
    Commented Jan 13, 2017 at 1:57
  • 1
    "domain name and subdomain name labels can contain leading underscores, but nowhere else." Not true at all. You can completely have foo_bar TXT gotcha in the DNS. At any level. You are focusing on SRV records that do have a specific syntax, but they are far from the only record types available in the DNS. Commented Feb 17, 2022 at 15:11
13

Recently the CAB-forum (*) decided that

All certificates containing an underscore character in any dNSName entry and having a validity period of more than 30 days MUST be revoked prior to January 15, 2019. https://cabforum.org/2018/11/12/ballot-sc-12-sunset-of-underscores-in-dnsnames/

This means that you are no longer allowed to use underscores in domains that will have a ssl/tls certificate.

(*) The Certification Authority Browser Forum (CA/Browser Forum) is a voluntary gathering of leading Certificate Issuers (as defined in Section 2.1(a)(1) and (2) below) and vendors of Internet browser software and other applications that use certificates (Certificate Consumers, as defined in Section 2.1(a)(3) below).

1
  • They weren't allowed before. That was a grace period after some CAs were caught violating the rules and wanted time to transition their customers. Commented May 25, 2021 at 15:24
7

As of 2023, there are websites appearing on Google search whose subdomains contain underscores, like https://my_sarisari_store.typepad.com

3
  • Give us some example please..? Commented Jan 27, 2023 at 15:42
  • Some sites in keybase file system have underscores in subdomain. Commented Jan 29, 2023 at 1:51
  • in the case of https://my_sarisari_store.typepad.com the certificate does not contain underscores. It is valid because the SAN includes the wildcard *.typepad.com.
    – Lobz
    Commented Feb 8 at 15:35
6

I followed the link to RFC1034 and read most of it and was surprised to see this:

The labels must follow the rules for ARPANET host names. They must start with a letter, end with a letter or digit, and have as interior characters only letters, digits, and hyphen. There are also some restrictions on the length. Labels must be 63 characters or less.

For clarification, a domain names are made up of labels which are separated by dots ".". This spec must be outdated because it doesn't mention the use of underscores. I can understand the confusion if anybody stumbles over this spec without knowing it is obsolete. It is obsolete, isn't it?

I followed the link to RFC2181 and read some of it. Especially where it pertains to the issue of what is an authoritative, or canonical, name and the issue of what makes a valid DNS label.

As posted earlier it states there's only a length restriction then to sum it up it reads:

(about names and valid labels)

These are already adequately specified, however the specifications seem to be sometimes ignored. We seek to reinforce the existing specifications.

Kind of leaves me wondering if "a length only restriction" is "adequate". Are we going to start seeing domain names like @#$%!! soon? Isn't the internet screwed up enough?

1
  • 3
    No, it is not obsolete. RFC1034 is a specification about host names, a special case of domain names, which are generic identifiers of resources in the DNS database. For example, the "host" part of URIs is defined rather relaxedly (tools.ietf.org/html/rfc3986#section-3.2.2) but the RFC cautions: "A host identified by a registered name is a sequence of characters usually intended for lookup within a locally defined host or service name registry ... a registered name intended for lookup in the DNS uses the syntax defined in Section 3.5 of [RFC1034] and Section 2.1 of [RFC1123]." Commented Jan 30, 2013 at 15:31
3

Regardless of the host name vs domain name discussion, it is definately a very bad idea to use underscores in the host part of a url. It will cause you grief. It may well work in a browser, but in one case I ran into recently an app refused to make a tls connection with a perfectly valid wildcard certificate for *.s3. amazonaws.com because the wildcard host name part had an underscore in it and would not validate. I believe the underlying library used openssl.

2

Here my 2 cents from Java world:

From a Spark Scala console, with Java 8:

scala> new java.net.URI("spark://spark_master").getHost
res10: String = null

scala> new java.net.URI("spark://spark-master").getHost
res11: String = spark-master

scala> new java.net.URI("spark://spark_master.google.fr").getHost
res12: String = null

scala> new java.net.URI("spark://spark.master.google.fr").getHost
res13: String = spark.master.google.fr

scala> new java.net.URI("spark://spark-master.google.fr:3434").getHost
res14: String = spark-master.google.fr

scala> new java.net.URI("spark://spark-master.goo_gle.fr:3434").getHost
res15: String = null

It's definitely a bad idea ^^

1
  • 3
    URI is stricter than URL. if you use java.net.URL constructor instead, all your tests will produce some host. Commented Sep 7, 2023 at 17:07
2

Individual TLD's can place their own rules & restrictions on domains names as they see fit, such as to accomodate local languages.

For example, according to the CIRA, Canada's .ca domain names are allowed:

  • Letters a through z, and the following accented characters: é ë ê è â à æ ô œ ù û ü ç î ï ÿ. Note that Domain Names are not case sensitive. This means there will be no distinction made between upper case letters and lower case letters (A = a);

  • The numbers 0123456789, and

  • The hyphen character ("-) (although it cannot be used to start or end a Domain Name).

The maximum length is 63 characters, except each accented character reduces that limit by 4 characters.

(Source)


Incidentally, this allows for around 4 Quadragintillion domain name possibilities (not counting sub-domains) for dot-ca domains.

-2

Just created local project (with vagrant) and it was working perfectly when accessed over ip address. Then I added some_name.test to hosts file and tried accessing it that way, but I was getting "bad request - 400" all the time. Wasted hours until I figured out that just changing domain name to some-name.test solves the problem. So at least locally on Mac OS it's not working.

-2

No, you can't use underscore in subdomain but hypen (dash). i.e my-subdomain.agahost.com is acceptable and my_subdomain.agahost.com would not be acceptable.

1
  • Somebody should tell this Microsoft. IIS allows underscores in subdomains and then one wonders as a layman why there are problems on some systems ... Commented Sep 13, 2021 at 13:49

Not the answer you're looking for? Browse other questions tagged or ask your own question.