Adding custom domain

To avoid frustrating cookie issues and to enhance your branding, use a custom domain.

By default, you have a Frontegg Domain. This domain ends with .frontegg.com. By using this Frontegg Domain, however, you may encounter unwanted cookie issues and use a domain that is not consistent with your brand.

Read below to learn more.

Why Use a Custom Domain

Avoid Cookie Issues

Some browsers block third party cookies by default. Providing a custom domain as your application UI domain will give you the ability to support these browsers.

Enhance Your Brand

Instead of seeing .frontegg.com in your domain, you might prefer to have your customers see your custom domain. For instance, when your customers use your application to login, your application might direct them to the following URL:

https://your-application.frontegg.com/oauth/account/login

Rather than see a domain with .frontegg.com in it, you might prefer that your customer see your domain instead.

Read below to learn how to configure a custom domain.

Configure Custom Domain

In the Frontegg portal, go to Environments ➜ [NAME OF ENVIRONMENT] ➜ Settings ➜ Domains.

📘

For instance, go to the development environment at Environments ➜ Development ➜ Settings ➜ Domains.

On this page, you can manage your Frontegg Domains. You should see your Frontegg Domain and also a place to add a Custom Domain.

2880

🚧

Be sure to manage the custom domains in each environment separately.


In the Custom Domain section, click the Configure button. You should see a dialog appear that asks for your domain name and gives you the information you need for creating the CNAME record in your DNS configuration.

As the instructions in the dialog indicate, add the CNAME record to the DNS configuration with your DNS provider.


🚧

Use Subdomain as Custom Domain

A common practice is to use a subdomains as the custom domain because if your app is hosted on app.sample.com and you have an existing A Record for that domain, you cannot use app.sample.com as a custom domain on Frontegg. Instead, use a subdomain as the custom domain, like auth.sample.com.


After adding the CNAME to your DNS configuration, click the Verify button.

📘

SSL Certificate

Frontegg generates an SSL certificate for your custom domain.


If Frontegg is able to verify the CNAME record, you will see a success message.

After a successful setup, you also should see your custom domain listed on the Administration Page's Domain tab with a verified tag.

📘

Frontegg SDK

When you're using a custom domain on Frontegg, that should be also the domain that you're passing as the baseUrl in the contextOptions in your Frontend integration package.


📘

In the setup, you may encounter an error if Frontegg is unable to verify your custom domain. If that happens to you, double check that you entered your CNAME correctly with your DNS provider and try again.