Trial Licenses

All licenses have a Boolean field denoting whether it is a trial or not. This can be seen on the license summary as well as the license detail page:

By using the is_trial Boolean designating a license is of type trial, you have a flag that allows you to configure your software in demo mode.

Particularities of a Trial License

• Trial licenses are the only type of license that can be issued through the License API. In other words, your application can request and activate a trial license without the software vendor's involvement.
• By changing the Boolean value of the is_trial field from True to False, you can upgrade a license.
• Since any license type can also be a trial license, you might notice that a perpetual or a consumption license can also have an expiry date.

When a license is a trial license, the expiry date for that license always refers to the trial expiry date.

Setting a Trial Expiration Date Through the Vendor Platform

You can either set a fixed end date, or a set number of days from the first use of the trial license:

Before activation you have two options - you can either set trial_days OR validity_period on a trial license. If both are defined on a trial license, when this license is activated, validity_period will take precedence and License API will use this field and ignore trial_days. If only trial_days are defined, then validity_period will be calculated and used to determine license validity.

Use only trial_days if you want the validity_period to be calculated at the time of activation based on this number.

Use validity_period if you already know, even before activation, until when this license should be valid.

“Upgrading” a Trial License

Any trial license can be edited to modify the license so that it is no longer a trial license, but a full license for your product. To do so:

1

Open the license detail page

Open the license detail page for that given trial license and click "Edit License".

2

Disable trial and save

Uncheck the "Is Trial" box, and click "Save".

Issuing New Trial Licenses

There are a few ways that a trial license can be issued:

• Through the vendor platform on Issuing New Licenses view
• Through the License API using Trial Key endpoint
• Through the Management API using Create Order endpoint