Domain Tags

Tags can be created any way you like an be assigned to Domains and TLD Zones. Our system offers two different types of Tags:

• TLD Zone Tags: Automatically apply to all domains of a certain TLD Zone.
• Domain Tags: Must be assigned explicitly to domains.

Tags also show up in your domainlist.csv file, available in your new CentralNic Reseller Control Panel at "Downloads" -> "My Downloads" Download, or in your old CentralNic Reseller Control Panel at "Account" -> "FTP". Internally we're handling Tags with a unique ID, and not with a unique name to allow name changes at a later time. However, the name must be unique for each type. If an object (e.g. a Domain) is deleted, the Tags are saved so they can be retrieved upon a restore. However, this only applies if respective Tags have not been deleted in the meantime. Multiple Tags can be stated in query commands and work as logical conjunction. The response lists the intersection, i.e. all objects assigned to all Tags stated in the query command. Important: All objects you would like to tag, like Domains, need to be in your account, i.e. you cannot assign Tags to objects not managed inside your account. As a logical consequence, Tags will be removed from objects when they leave your account, for example when a Domain is transferred out of your account. Directly affected commands are TransferDomain and PushObject. When executed successfully, the Domain looses all Tag assignments.

How it works

Tags can currently be created for and assigned to Domains and TLD Zones. The simple approach is:

1. Create a Tag
2. Assign a Tag to an object
3. Use the Tags!

Tags can be used for many purposes and they have been integrated in several commands.

Domain Tags

Domain Tags can be assigned directly to Domains using AddTag an will show up in responses of various commands. Also, Domain Tags will show up in the domainlist.csv file in your FTP area. Domain Tags can also be assigned using AddDomain and ModifyDomain, even if the respective Tags don't exist yet. If a Tag doesn't exist, it will be created. In case a Tag can not be created (e.g. because of invalid or too many characters), this Tag will be ignored and the command response will show an error: property[error][X]
In case a Tag not assigned to a certain Domain shall be removed from this Domain, it will be simply ignored without throwing an error.

TLD Zone Tags

Of course you can create new Tags for TLD Zones and thus you can set up a single Tag for a whole bunch of TLDs, making the management a bit easier. And these Tags for TLD Zones - both default Tags and individually created - automatically apply to all Domains of the respective TLD Zones, i.e. these do not need to be added to single Domains explicitly.
Our system offers default Tags for TLD Zones which automatically apply to all Domains of the respective TLD Zones. Those Tags can be recognised easily as they all start with DEFAULT_ and cannot be deleted or modified.
For example using

Command=QueryDomainlist
ZoneTag0=DEFAULT_GENERIC

lists all Domains of generic TLDs.
TLD Zone Tags can be applied for inactive TLD Zones as well. Default Tags can exist for inactive zones as well.
Important: Only valid Zones will work, i.e. only those that exist in the Metaregistry.

Default Tags

Default Tags can be used for Domains and TLD Zones, as well as template using the parameter COPY when using AddTag.
Important: Tag names starting with DEFAULT_ are reserved for Default Tags:

• DEFAULT_ADULT
• DEFAULT_BRAND
• DEFAULT_CENTRALNIC
• DEFAULT_COMMERCE
• DEFAULT_COMPANY
• DEFAULT_COMPUTER
• DEFAULT_CULTURE
• DEFAULT_EDUCATION
• DEFAULT_ENVIRONMENT
• DEFAULT_FAMILY
• DEFAULT_FASHION
• DEFAULT_FINANCIAL
• DEFAULT_FOOD
• DEFAULT_GENERIC
• DEFAULT_GEOGRAPHIC
• DEFAULT_GEOGRAPHIC/AFRICA
• DEFAULT_GEOGRAPHIC/AMERICA
• DEFAULT_GEOGRAPHIC/ASIA
• DEFAULT_GEOGRAPHIC/AUSTRALIA
• DEFAULT_GEOGRAPHIC/EUROPE
• DEFAULT_GEOGRAPHIC/MIDDLEEAST
• DEFAULT_GEOGRAPHIC/OCEANIA
• DEFAULT_GEOGRAPHIC/SOUTHAMERICA
• DEFAULT_HEALTH
• DEFAULT_IDN/
• DEFAULT_IDN/ARABIC
• DEFAULT_IDN/CHINESE
• DEFAULT_IDN/CYRILLIC
• DEFAULT_IDN/DEVANAGARI
• DEFAULT_IDN/HEBREW
• DEFAULT_IDN/JAPANESE
• DEFAULT_IDN/THAI
• DEFAULT_INTEREST
• DEFAULT_LIFESTYLE
• DEFAULT_MEDIA
• DEFAULT_OTHER
• DEFAULT_POLITICS
• DEFAULT_PUBLICITY
• DEFAULT_REGIONAL
• DEFAULT_RELIGION
• DEFAULT_SPORT
• DEFAULT_TECHNOLOGY
• DEFAULT_THIRDLEVEL
• DEFAULT_VEHICLE

Technical Specification for Tags

• maximum length 64 characters
• Zone Tags cannot start with "DEFAULT_"
• Tags cannot have the name "0" (number zero)
• 100 Tags maximum per Domain
• no limitation for Tag Zones per TLD/zone Tag since default groups can be large
• all special and unicode characters can be used for Tags.
• The ACL group for Tag commands is TOOLS. So if you want to grant access to Tag commands to users of your CentralNic Reseller account, the group TOOLS must be activated for them.

Additional Parameters and Responses for Commands

Important: Tags can not be assigned using TransferDomain, since transfers are often not in real-time.

Parameters for Query Commands

The following API commands now support the COMMAND parameters DomainTag[0-4095]= and ZoneTag[0-4095]= to limit the search results:

• QueryRegisteredPremiumDomainList
• QueryDomainRenewList
• QueryTrusteeDomainList
• QueryAccountingList
• QueryDomainListByContact
• QueryDomainHistoryList
• QueryUpcomingAccountingList
• QueryDomainExpireList
• QueryDomainList

Example parameters:
...
ZoneTag0=
...
ZoneTag4095=
...
DomainTag0=
...
DomainTag4095=
...

Responses for StatusDomain, StatusDomain and GetZoneInfo

The following API commands now additionally respond with property[domaintag][0-X]=

• StatusDomainHistory
• StatusDomain

GetZoneInfo now additionally responds with property[tag][0-X]=

AddDomain

AddDomain now supports DOMAINTAG[0-4095]= for the direct assignment of Tags during the registration request.
Example parameters:
[[AddDomain|AddDomain]]
DomainTag0=
DomainTagN=
- or -
AddDomainTag0=
AddDomainTagN=

ModifyDomain

ModifyDomain now supports DOMAINTAG[0-4095]= for direct assignment of Tags during the registration request along with ADDDOMAINTAG[0-4095]= and DELDOMAINTAG[0-4095]=.
Example parameters:
[[ModifyDomain|ModifyDomain]]
DomainTag0=
DomainTagN=
- or -
AddDomainTag0=
AddDomainTagN=
DelDomainTag0=
DelDomainTagN=

Using Query Commands with Tags

We integrated Tag support for Several Query Commands:

• QueryDomainList
• QueryAccountingList
• QueryDomainExpireList
• QueryDomainHistoryList
• QueryDomainListByContact
• QueryDomainRenewList
• QueryRegisteredPremiumDomainList
• QueryTrusteeDomainList
• QueryUpcomingAccountingList

Sub-Reseller Management with TLD Zone Tags

Tags can be used to activate TLD zones for Sub-Resellers, during the creation (AddRegistrar) and modification (ModifyRegistrar) of a Sub-Reseller account. Important: Tags are not inherited to Sub-Reseller accounts!