Using Domain Tags in our system allows you to query for data in a more directed way than would otherwise be possible. You can create specific tags and add them to domains, for example, to narrow down the list of domains returned by Query commands when checking for specific domains under your management.
Examples of Use Cases
- Reseller's customer account number or the customer name as domain tag.
- A tag for ccTLDs or gTLDs in your account, for your own stats.
- By adding the "Trustee" tag, you can quickly check how many domains are using this service.
- If you are a domain broker, you could set a tag for "Parked" domains or "Live" websites.
- You might want to sort your domains by industry, geographic location or any other type.
Adding Tags
You can create your own tags and add them to domains via AddTag, AddDomain and ModifyDomain commands, as described in our article about Domain Tags & Comments:
https://kb.centralnicreseller.com/domains/tags-and-comments
Via AddTag
COMMAND = AddTag
TYPE = DOMAIN
TAG = (TEXT)
DOMAIN0 = (Optional)
More details can be found in our article about the AddTag command.
Via AddDomain
COMMAND = AddDomain
DOMAIN = example.com
DOMAINTAG0 = (TEXT)
Via ModifyDomain
COMMAND = ModifyDomain
DOMAIN = example.com
ADDDOMAINTAG0 = (TEXT)
Also, from your Control Panel, as shown in the screenshot:
Modifying and Deleting Tags
It's possible to modify a tag via the ModifyTag command:
COMMAND = ModifyTag
TYPE = DOMAIN
TAG = (TEXT)
You can delete a tag via the DeleteTag command:
COMMAND = DeleteTag
TYPE = DOMAIN
TAG = (TEXT)
They can also be deleted via the ModifyDomain command:
COMMAND = ModifyDomain
DOMAIN = example.com
DELDOMAINTAG0 = (TEXT)
Additional Commands
The QueryTagList command shows a list of all created tags and offers various search possibilities. Please check our article about QueryTagList.
The StatusTag command shows basic information about the tag and the number of assigned objects. Please check our article about StatusTag.
Querying Domains by Tags
You can sort your domain list by specific tags from your Control Panel -> Domains, as shown in the screenshot:
If you want the list to display the "tags" column, you can modify the layout of the table by clicking on the settings wheel as shown in the screenshot, and then by checking off the Domaintags box.
As per the example above, by using the tag "green", the list would look like this:
You can notice that if the domain has more than one tag, they are displayed in the column.
The list can be generated via API, of course. For example:
Command = QueryDomainList
DomainTag0 = green
[RESPONSE]
code = 200
description = Command completed successfully
queuetime = 0
runtime = 0.02
property[column][0] = domain
property[count][0] = 11
property[domain][0] = de2019test04.de
property[domain][1] = ks-test-mihai-001.gr
property[domain][2] = ks-testing-0001.sg
property[domain][3] = ks-testing-00015.com
property[domain][4] = ks-testing-00017865t6u5.com
property[domain][5] = ks-testing-0017.hk
property[domain][6] = niksawesomedomain.com
property[domain][7] = niksawesomedomain.de
property[domain][8] = niksawesomedomain.es
property[domain][9] = niksawesomedomain.net
property[domain][10] = tradetest.at