Domain Contact Field Reference
Last updated
Table of Contents
- Field requirements
- Fields that depend on other fields
- Format requirements
- How values are stored
- How contacts are displayed
- What is not a contact field
- Have more questions?
Every domain contact in DNSimple has the same set of fields. Most are required, several have maximum lengths, and phone, fax, and country must be in a valid format. This page lists them all.
For how to create and edit contacts, see Managing Your Contacts.
Field requirements
| Field | Required | Maximum length | Notes |
|---|---|---|---|
| First name | Yes | 60 | |
| Last name | Yes | 60 | |
| Organization name | No | - | If set, job title becomes required |
| Job title | Only with an organization | 60 | |
| Email address | Yes | 128 | Stored in lowercase |
| Phone | Yes | 20 | International number with the country code |
| Fax | No | 20 | International number with the country code, if provided |
| Address line 1 | Yes | 60 | |
| Address line 2 | No | 60 | |
| City | Yes | 60 | |
| State or province | Yes | 60 | |
| Postal code | Yes | 16 | |
| Country | Yes | - | Must be a valid ISO 3166 country code |
| Label | No | - | Used to tell similar contacts apart |
Fields that depend on other fields
Job title is required only when an organization name is present. If you register domains as an individual, leave both blank. If you enter an organization name, you must also enter a job title.
Format requirements
Phone and fax numbers must include the country code. Enter the number in international (E.164) form: a plus sign, the country code, then the subscriber number. Spaces, dashes, and parentheses are accepted, so +1 (555) 123-4567 and +15551234567 both work. A number without the country code, such as (555) 123-4567, is rejected with the message “is probably not a phone number.” The 20-character limit counts the number as you type it, including spaces and punctuation.
Country must be a valid ISO 3166 code. The contact form presents this as a country picker, so you do not normally enter the code by hand.
How values are stored
DNSimple normalizes contact values on save:
- Leading and trailing whitespace is removed from every text field except the label
- Email addresses are converted to lowercase
- Country codes are converted to uppercase
- Phone and fax numbers are saved as the country code, a dot, and the subscriber number, for example
+1.5551234567
A field containing only spaces is treated as blank, so it will not satisfy a required field.
How contacts are displayed
A contact displays by its label when one is set, and by first and last name otherwise. Labels are useful when the same person appears as a contact more than once, for example a personal contact and a company contact with the same name.
What is not a contact field
Extended attributes are not contact fields. Some TLDs require additional registry-specific information, such as a registrant type or a local tax identifier. These are collected during registration and during a registrant change, they vary by TLD, and they are not stored on the contact itself. Domains using domain trustee show only the extended attributes that still apply for that trustee configuration.
Have more questions?
If you have any questions about domain contact fields, just contact support, and we’ll be happy to help.