In the process of building a new website, you may need to use more than one URL. Staging.yourwebsite.com for instance. That way you can complete development without replacing an existing live website.
If you take this approach, you’ll need to add that domain to your Sitefinity CMS license. This post will explain how you do that. It’s a fairly simple process, but an essential one!
Reasons a Domain License Update is Needed
You’ll need to add a domain to your Sitefinity license whenever you:
- Add a secondary or additional domain (e.g. Domain1.com and Domain2.com)
- Add a production domain before the new website goes live
- Convert from one domain to another
Every Sitefinity website’s domain license MUST include all domains for which the website responds. Domains themselves work by DNS records. But if your Sitefinity instance doesn’t know to respond to those DNS requests, the domains won’t work properly. So this becomes an important part of activating any new websites, or adding on domains.
Domain License Update Part 1: Update Your Sitefinity License Key
Which process you use depends on what type of domain work you’re doing.
If Adding a Domain Alias or Staging Domain:
Log into your Telerik.com Account. (It’s still at Telerik.com for now.) This is a separate login from your Sitefinity user account, as well as your Progress.com account.
Click on the ”Products & Subscriptions” menu. You should see a “Sitefinity CMS” entry on its menu. Click it.
In the side menu on the resulting page, click on “Manage Domains and Licenses.”
On the next page, locate your domain. Click the Manage button to its right.
You’ll see the Single License Management page. Click the Add Domain button.
You’ll see an Add Domain window. Enter the domain you want in the text box, and select either Staging or Alias.
- Staging Domain: Used for non-production purposes, e.g. website development
- Alias Domain: Alternative domain someone can use to access the same website, e.g. YourDomain.com and YourOtherDomain.com pointing to the same website.
Domain aliases & staging domains don’t require Telerik/Progress approval. You don’t have to email them after doing this. All you have to do now is download the updated license key file.
If Adding a Production Domain OR Converting from One Domain to Another:
Email email@example.com to request a production domain change. Give your Telerik Customer Number if you have it (it’s in your Telerik profile), as well as the website’s original domain name. Production domain change requests normally take 24-48 hours.
Once you’re notified that the change is in place, log into your Telerik.com Account. You may need the license key file for Part 2. To find the license key, read the below instructions.
Download Your Sitefinity License Key File
(If you’ve added a staging domain/domain alias, skip to Step 4.)
- Click on the ”Products & Subscriptions” menu. You should see a “Sitefinity CMS” entry on its menu. Click it.
- In the side menu on the resulting page, click on “Manage Domains and Licenses.”
- On the next page, locate your domain. Click the Manage button to its right.
- On the Single License Management page, click the License Keys button on the toolbar.
- Locate the Sitefinity version number your website currently uses. Click the Download link to its right, to download the updated license key.
*IMPORTANT: Make sure you download the proper license key! It should exactly match the Sitefinity version number in your website’s CMS. If you’re not sure which version, log into your website’s Sitefinity backend. Click the “Administration” menu. Click the “Version & Licensing” entry. This will tell you the proper version number.
Domain License Update Part 2: Update the License Within Your Sitefinity CMS
- Log into your website’s Sitefinity backend with an Administrator account.
- Click the “Administration” menu.
- Click the “Version & Licensing” entry.
- If you have a newer version of Sitefinity (8+ and above), you will see an Update License button. This button requests a fresh copy of the Sitefinity license key from Progress.
- All you have to do is click it. You’ll see a window like this pop up:
- Click Continue.
- You should return to the Sitefinity Dashboard, which means the license is updated.
If you have an older (pre-8), you won’t have this button. You’ll have to do a manual update. This is only a few more steps.
- Follow Steps 1-3 above.
- On the Version & Licensing page, click the Activate New button.
- Choose the “Use a license file you have downloaded” option.
- Click “Choose File.” Locate the license key file you downloaded, and select it.
- Once you have it selected, click the Activate License button.
- In a few seconds, you should see the “Confirm License” window pop up (like we saw earlier).
- Click Continue.
- You should return to the Sitefinity Dashboard. License updated!
Make Sure You Add a New Domain Before the Website Goes Live
One final point I should make. If you’re only adding a domain alias or staging domain, you can do it at any point in development. It won’t affect the website’s functionality.
However, if you’re changing the production domain, you should do this the week of launch. This CAN affect access to the website. You don’t want to accidentally cut yourself off two days before launch!
What’s your experience with Sitefinity domain licensing?