Custom domain (CNAME)

• 🧰 DNS configuration
• 👉 How to set up a custom domain (CNAME)
• 🔗 How to add a custom domain to a workspace
• 👉 How to add your Favicon
• 🔎 Custom domain particularities
• ❌ Delete a custom domain
• ❓ FAQs

You can now link your custom domain to the platform to personalize your Sessions Workspace account. Remember, the process requires you to have a domain purchased and already set up.

🧰 DNS configuration

Below is a quick guide on how to set up a custom domain with Sessions:

Let's say your domain name is domain.com and you choose your subdomain to be “meet”.

1. On your side you will have the following DNS settings:

3. In some cases, it may not be required to add the dot at the end of the value field. You can try both with and without.

4. In Sessions’ Custom domain page, you will enter: meet.domain.com. You will need to configure this according to your own domain and chosen subdomain.
5. If all is working, an SSL certificate message will appear. It might take a while depending on your provider, so please give it some time.
6. After this is done, a new button will appear: Visit domain. Click on it.
7. It will redirect you to the authentication page using the new URL, where you can enter your Sessions credentials and continue using the app with the new URL.

👉 How to set up a custom domain (CNAME)

1. Go to your Profile (lower left corner).
2. Go to Organization settings.

3. Go to Custom domain.

4. Click on Add custom domain.

5. Choose a subdomain and type it followed by your domain (e.g. your domain is testexample.com and you want ‘app’ as a subdomain, type in app.testexample.com). Click Add domain.
6. Click on Verify.

7. Click on Edit domain.


8. From the table, copy the CNAME value and go to your DNS settings page.
9. Add this value as CNAME for the following records in your DNS configuration that you need to create:
• Sessions app: <your.domain>
• Sessions services:
• event.<your.domain>
• api.<your.domain>
• auth.<your.domain>
💡
Please make sure all values are in lowercase letters (not CAPITAL letters) as this can cause validation issues.

10. If the DNS setup for your domain doesn't contain any CAA records, you're ready to go.

If however, you do have CAA Records, please follow these additional steps:

• Check if the list of authorized issuers includes "letsencrypt.org" and "sectigo.com".
• If either one is missing, please add the corresponding CAA record using the values below

0 issue "letsencrypt.org"

0 issue "sectigo.com"

11. Back in Sessions, you’ll see two statuses next to your domain: “Waiting for DNS” and “Waiting for SSL”. This step can take a few minutes to process.

12. If everything is in order, the status will eventually change to Ready.

👉

If the domain is invalid or has been previously added, you’ll get an error. It's not possible to link the same custom domain to multiple workspaces or two domains under the same workspace. You’ll need to choose a different domain.

🔗 How to add a custom domain to a workspace

1. Configure your custom domain from Profile → Organization settings → Custom domain. (see the configuration steps detailed above, under “How to set up a custom domain”).
2. Switch to the workspace you want to add a custom domain to (bottom left corner, above your profile).
3. Go to your profile (bottom left corner).
4. Click on Workspace settings → General settings.
5. Under Workspace domain, select which custom domain you want for that specific workspace.
6. Repeat the steps for all your workspaces.

👉 How to add your Favicon

1. Set up your custom domain. More info here: 📝Custom domain (CNAME).
2. After you have your domain set up, go to your profile in Sessions.
3. Click on Organization settings.
4. Go to Custom domains.
5. Scroll down to Favicon.
6. Click on Upload.
7. Select a PNG or JPG file with a 1:1 ratio and a minimum size of 512 x 512 pixels to display in browser tabs.
8. Click Save.
9. Done.

🔎 Custom domain particularities

• Only Workspace Administrators can set up custom domains.
• The Sessions domain will still be available to you. You can access both at any given time.
• Email notifications will be sent for your custom domain, if the custom domain is active and ready. The invitation link that your participants will receive will be for this domain (your.domain/session/etc.). When the custom domain is disabled, the links will be sent with the Sessions domain (app.sessions.us/session/etc.).
• For security reasons, every action that requires authentication between Sessions and outside providers, will be done on the Sessions domain. This includes:
• Sync for Calendars: You will be redirected to the Sessions domain in a new tab. After you manage your connections, you will be able to see them both in the Sessions domain and your custom domain.
• Any integration that requires authentication (Google Word, Google Slides, Google Sheets, etc.): You will be redirected to the Sessions domain in a new tab. After the sync is done, you can use the tools in the Sessions domain or your custom domain.
• In the Lobby of Planned sessions or during live gatherings, you will be able to start the sync process for tools that require it (Google Word, Google Sheets, Notion, Evernote).

You will also be redirected to a new tab to the Sessions domain, where the authentication process will take place. When it is done, you will need to refresh the original tab with your Planned session or live meeting for the changes to take effect.

To avoid this hassle, we advise you to review these steps before the session or event is live.

❌ Delete a custom domain

Once you switch off the toggle, it will completely delete the link to your custom domain.

Note: If you’ve created sessions or events and invited others, they will see an error message when trying to access the gathering’s link on your custom domain. They will not be redirected to the Sessions domain.

Temporary workaround: Go to your Sessions account and make a change to your session’s name or date. This will trigger an email notification for your participants that you’ve made changes to the session, and it will include the session’s link from the Sessions domain.

❓ FAQs