Image: Sample application URL with custom domain

Prerequisites 

1. You must own any Zoho IOT Plan that provides privileges for configuring a custom domain.
   
2. You must have Administrator privileges in the application.
   
3. You must own the domain e.g. zylker.com.
   
   

Steps to Configure the Map Custom Domain 

Mapping Custom Domain to Zoho IOT  application

1. Access the Developer Application.
   
2. In the Visualize tab, click Rebranding.
   
3. Select the Custom Domain tab.
   
4. Click the Map Custom Domain button.
   
   
   
   
5. Select the Add Domain tab,
   
   
1. Provide the Base Domain and Sub Domain name. The full custom domain name will be displayed in the Full Custom Domain Name text box.
   
   
   
   
2. Verify and click Save and Proceed.
   
   

Ownership Verification 

1. Copy the domain information, such as name and value from the Custom Domain Configuration's Verify Ownership tab in the Zoho IOT application as given below.
   

2. Go to the DNS Management page of your domain provider and create a CNAME record by providing the copied name and value as given below. 

Image: Example Domain Provider's DNS Page

3. Once the CNAME record is created in the DNS Management page, Click Verify in the Verify Ownership tab in the application.

4. If the verification fails, the Custom Domain status remains as "Verification Pending" and the Verification Pending Alert is displayed.

Note: The verification process can take a few minutes to hours.

5. Click the Verify Ownership button.

Once the domain is verified, the Custom Domain status will be updated as "Certificate Installation Pending" and the Activation Pending Alert will be displayed.

Image: Activation Pending alert is displayed after verification is passed.

Note: Once verified, the SSL certificate generation and deployment process will be initiated, and you will receive a mail with subject "Custom Domain energymonitoring.zylker.com has been Verified". And a second mail with subject "SSL Certificate Request". 

  

Within 2-3 days, the SSL certificate will be installed, and you will receive a mail with subject "Custom Domain <domain url> is now Active and Secure." and the same will be reflected in the Custom Domain Configuration page.  

Enabling/Disabling Custom Domain

1. Access the Developer application.
   
2. In the Visualize tab, click Rebranding.
   
3. Select the Custom Domain tab.
   
4. Select OFF in the Status toggle button.
   
    

5. Click Disable in the Custom Domain Disable Confirmation popup box. The custom domain mapping will be disabled.

Warning: An ERROR will be displayed when the mapping is still enabled, but there is an issue in the domain access due to various reasons. For example, if the domain license has expired and needs to be renewed.

Note: If there are any errors in domain access, such as the domain license has expired, you need to disable the domain access in the application. After disabling the domain, whenever the custom domain URL is provided to access the application, the user will be redirected to the default application domain.  

You will not be able to access the application with any error without disabling the custom domain feature in the application.

Example default application URL:
app661348igilz.zohoiot.com 

1. Select ON in the Status toggle button.

Deleting Custom Domain  

1. Access the Developer Application.
   
2. In the Visualize tab, click Rebranding.
   
3. Select the Custom Domain tab.
   
4. Verify that the Status is OFF (i.e. in disabled state)
   
5. Click Delete link to delete the mapping.
   
   

6. Click Delete in the confirmation screen.

Note: After deleting, the CNAME must be removed in the DNS Management page of your domain provider. This is to facilitate creating a domain with the same name in future.