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

You’ll 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

 

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