Use Custom Domains For Portals

1. Feature Overview

You can host Portals built with LeadSquared on –

  1. Our default domain – lsqportal.com. For more details, see Portal Configurations.
  2. Your own custom business/brand sub-domain (e.g., applications.mybusiness.com).

This article describes how you can host a portal on your own custom domain.

portal custom domain

 

2. Prerequisites

  1. You must be a LeadSquared Administrator user.
  2. You must first list the domain on the Website & Landing Page Domains page. For details, see Adding More Website Domains.
  3. Access to your Domain Name Service (DNS) provider’s account (GoDaddy, Hostgator, Bluehost, etc.).

 

3. How It Works

Create 2 CNAME records in your DNS provider’s account – one pointing to a certificate manager for HTTPS security, and the other pointing to the actual sub-domain for your portal (e.g. applications.mybusiness.com).
The setup requires you to go back and forth between the portal domain settings in your LeadSquared account and the CNAME record settings in your DNS provider’s account.

This section provides a summary of the setup, the following sections elaborate on each step –

  1. Create and configure the sub-domain in your LeadSquared account.
  2. A Name and Value will be generated. Copy the values, and use them to create a CNAME record in your DNS provider’s account. This step sets up a HTTPS certificate to ensure better security for your portal (for more details, see Why HTTPS matters).
  3. Come back to your LeadSquared account, and verify that the settings in your DNS (for the HTTPS certificate) have taken effect.
  4. After successful verification, you’ll receive a CDN URL from us. Create a new CNAME record for the sub-domain using the CDN URL.
  5. Your portal is now live and ready to use.

 

4. Configure the Sub-domain in LeadSquared

  1. On the main menu, navigate to Workflow>Manage Portals and select your portal.
  2. On the top navigation bar, select the Settings tab.
  3. On the left menu, select Domain.
  4. Enable the Use Custom Domain slider Zoom .
  5. Select a domain from the drop-down and enter the sub-domain name.
  6. Click Confirm
  7. Copy the generated Name and Value.

Publish portal on custom domain

 

5. Create a CNAME Record for HTTPS Certificate

In this step, you’ll create a CNAME record in your DNS that points to a Certificate Manager and creates a Transport Layer Security (TLS) certificate for your domain. TLS is a security protocol that uses encryption to protect the transfer of data to and from your portal.

Here is some documentation for popular DNS providers –

  1. GoDaddy: Add a CNAME record
  2. Namecheap: How to Create a CNAME Record For Your Domain
  3. Dreamhost: Adding a Custom DNS record
  4. Bluehost: DNS Management: How to Add, Edit, or Delete DNS Entries

Log in to your Domain Name Service provider’s account (GoDaddy, Hostgator, Bluehost, etc.).

  1. Click on the DNS settings for the selected URL and create a new CNAME record entry. Paste the above values in the Name (or Host) and Value (or Target) fields, respectively.
  2. Select the minimum TTL value available.
  3. Save the record.
  4. Successful configurations may take some time to reflect.

Here’s an example from a GoDaddy.com account –

CNAME record in GoDaddy

 

6. Verify the Settings in LeadSquared

Navigate back to your LeadSquared account and on the Portal Domain Setting page, click Verify

Verify domain Portals

Note: The request for CNAME record entries are valid for only 72hrs. You must complete the steps below within the window. If you miss it, unlink the sub-domain name and recreate it following the steps above to raise the request again.

After successful verification, you’ll receive a CDN URL. Copy this URL and use it to create a CNAME record for the sub-domain.

CDN URL for CNAME record portals

 

7. Create a CNAME record for the Sub-Domain

Note: If your portal is not published to the Live environment, you won’t be able to configure the next step.  You’ll see the following prompt on the Portal Dashboard page. Click on “Complete Domain Linking” to proceed –

complete domain linking on portals

Finally, map the sub-domain with the portal –

  1. In your DNS provider’s account, click the DNS settings for the selected URL and create a new
    CNAME record entry.
  2. Paste the sub-domain name (e.g. ‘applications’ from applications.mybusiness.com) the Name (or Host) and CDN URL in the Value (or Target) fields, respectively.
  3. Select the minimum TTL value available and save the record.

Here’s an example from a GoDaddy.com account –

Sub domain final configs CDN URL portals

Your portal is now live.

portal live domain settings

 

Troubleshooting Frequent Issues

I added the CNAME records in my DNS, but when I try and verify the settings in LeadSquared, I get an “Invalid Certificate Id” error. What’s causing the issue?

There are 2 reasons why this error may occur

  1. The request for entries for CNAME records are valid only for 72hrs. If you try and verify the domain outside this window, you’ll receive an “Invalid Certificate Error“. To resolve the issue, unlink the sub-domain name and reconfigure the domain setup in Portal Designer.
  2. Certificate Authority Authorization (CAA) DNS records configured in your domain provider’s settings are blocking LeadSquared from issuing an HTTPS certificate. To resolve this –
    1. Remove the custom domain setup from Portal Designer.
    2. Follow the steps in the Amazon CAA issues article to allow LeadSquared to issue a certificate.
    3. Remove the CNAME mapping for the portal (if already added) in your DNS provider’s settings.
    4. Reconfigure the domain setup in the LeadSquared Portal Designer.

When I try and add the CNAME record in my DNS provider’s account, I get a “Not able to add CNAME record” error. How do I fix the issue?

This error may be the result of a duplicate CNAME record. If the CNAME record was already created in your DNS settings, delete it, then add the new record.

What do I do if my DNS provider is cPANEL?

  1. If any sub-domain is present, delete it first.
  2. Then create a new CNAME record in the root domain.

 

Any Questions?

Leave us a comment below. We’d love to help you out!

Was this Helpful?

Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments