Activate and Use TestExecute

Applies to TestExecute 15.40, last modified on May 21, 2024

This page is related to new SmartBear ID-based licenses that we’ve introduced in TestComplete 14.9.
For information on regular key-based licenses that are also used in version 15.40, see Key-Based Licenses.

Since product version 14.9, we started offering licenses of the new (SmartBear ID-based) type to a limited number of users. This new license type implies that, to use the product, you need to specify your SmartBear account (or SmartBear ID). This is an easier and more convenient way of using the product as compared to downloading and installing license files. The information below describes the specifics of applying the new licenses.

How to create a SmartBear account

We create one for you automatically when you request a trial on our website. You will receive a notification message via email about this. We recommend that you follow the link in this email message and set a password for your account.

Note: We create an account for the email address you specified in the trial request form. Of course, if you already have an account for this email, a new one is not created.

Once you have an account, you can specify it in the product. See below.


The new licenses are controlled by SmartBear online License Servers. The computer where you are going to run TestExecute must have access to these servers. The proxies and firewalls running in your network should allow a permanent connection to them:


If you are working in a private network which has no access to these servers, you still can use ID-based licenses, but you need to convert them to offline ones. See Licensing in Private Networks.

Trial license

Option 1 — Requesting a trial from the website

In this case, the TestExecute trial doesn’t require any special activation. You can download, install, and run it. The trial installation has all the data needed for the run. It uses the SmartBear account that was created for you when you requested the trial.

You will receive an email message on the created SmartBear account. We recommend that you follow a link in that email and set a password for your account.

Option 2 — Requesting a trial from the application

If you have a commercial license for one of the TestExecute modules (Desktop, Web, or Mobile), you can also request a trial for another module. The way you do this depends on the license you are using.

If you are using a key-based license
  1. Currently, most commercial licenses are key-based. So, as the first step, you need to switch to the ID-based licensing. To do this, select Switch to SmartBear ID-based Licensing from the TestExecute menu:

    Switch to ID-based licensing

    After switching to ID-based licensing, TestExecute will ask you to specify your SmartBear ID credentials (email and password). If you don’t have a SmartBear account yet, you can create it right from this dialog.

  2. After you specified your SmartBear ID, TestExecute will check if you have a license or not.

    If you have no TestExecute licenses assigned to your SmartBear account, TestExecute will display a message suggesting that you start the trial:

    Start Trial dialog box

Commercial licenses

ID-based licenses can be Fixed User or Floating (see more on this in the SmartBear License Management documentation). The activation steps listed below work for both Fixed User and Floating licenses.

1. Admin steps — Assign the licenses to end-users

When purchasing a license, you specify the person who will represent the license administrator on your side, that is, who will have permissions to control the license use and assign the license to your teammates.

The license administrator works on the SmartBear Licensing Portal:

For complete information on assigning licenses, see SmartBear License Management Documentation.

If your teammates don’t have SmartBear accounts, the license admin can invite them to the Portal to get the accounts. It is essential to use corporate emails for the invitation, not the personal ones.

If needed, the license administrator can assign the licenses to themselves.

2. User steps

1. Complete account creation

If your license administrator assigns a license to you, and you have no SmartBear account, the Licensing Portal will send an invitation email to you. This email contains a link to the Portal. Follow this link and specify a password for your SmartBear account to complete the account creation. After that, you will be able to download the product installer from the Portal.

Of course, the Portal doesn’t send invitations to those who already have SmartBear accounts. These users receive notifications on assigned licenses.

2. Install TestExecute
  1. Download the TestExecute installer:

    1. Log in to the Portal:

    2. Find the product and your license there. Click the and select the needed version for downloading:

      Download the TestExecute installer from the Licensing Portal

      Click the image to enlarge it.

  2. Make sure your computer has access to the SmartBear license servers (see Requirements above).

    Run the downloaded installer and follow the instructions of the installation wizard.

    When the installation is over, the installer will automatically run TestExecute, which, in its turn, will ask you for activation.

3. Activate TestExecute
  1. If you haven’t started the product yet, start it.

  2. TestExecute will show a dialog box asking you to specify the email and password of your SmartBear account. Enter them:

    Entering your credentials

    Click the image to enlarge it.

    TestExecute will check if your SmartBear account has a license assigned to it. Further actions depend on whether you have a license or not.

    • If the license is found, no further actions are required from your side: TestExecute will consume the license seat, and you will be able to use the product.

      TestExecute will remember your credentials, so you don’t need to enter them every time you start the product.

    • If the license is absent, TestExecute will notify you about this and will suggest possible solutions.

Activation in CI/CD runs

You can use both trial and commercial licenses of TestExecute for automated runs. To do this, you need to copy an API key for your license from the SmartBear Licensing Portal and specify it in the TestExecute command line. For complete information, see Activate TestExecute in CI/CD build runs.

Activation in private networks

ID-based licenses are controlled and managed by SmartBear license servers available on the Web. If you are working in a private network, most probably, these servers are unavailable for you. To use TestExecute in these conditions, you have to convert your Fixed User or Floating license to an offline one and then activate it in a special way. See detailed instructions.

Helpful links

See Also

SmartBear ID-based Licenses
Activating Key-Based Licenses

Highlight search results