Understanding License Details #

Before creating or editing licenses, understand what each field means.

Core License Fields #

License Key #

The unique string identifier customers use to activate your software.

Format: DMSI-XXXX-XXXX-XXXX-XXXX

On Add New Screen:

• Empty text field for manual entry
• Blue [Generate Key] button to auto-create unique key
• Helper text: “Unique license key. Click Generate to create automatically.”

Recommendation: Always click Generate Key unless you’re migrating from another system.

Customer (Required) #

Who owns this license.

Field Type: Dropdown with searchable list of all customers

Helper text: “Customer who owns this license.”

Product (Required) #

Which WooCommerce product this license is for.

Field Type: Dropdown showing products with licensing enabled

Helper text: “Product this license is for.”

License Type (v1.2.0) #

The admin-defined License Type applied to this license. License Types are configured under Settings > License Types and define default parameters such as activation limit, duration, and permissions.

Field Type: Stored as the License Type slug (e.g., “standard”, “professional”)

How it is set:

• For licenses created from a purchase, the License Type is resolved from the product or variation configuration at order time.
• For manually created licenses, you select the License Type during creation.
• Once saved, the License Type field is read-only on the license record. It reflects the type that was in effect at creation time.

What it controls:

• Default activation limit
• Default license duration
• Whether the license is lifetime (no expiry) — see is_lifetime below
• Whether the license allows updates, premium content, and API access

Lifetime licenses (v1.2.2): If the License Type has is_lifetime set to true, the license is created with no expiration date (expires_at = null). The Expiration column on the Licenses screen displays “Never” for these licenses. This is determined by the License Type at creation time and cannot be changed by editing the expiration date field.

Activation Limit #

Number of installations allowed.

Field Type: Number field with spinner control

Default: Inherited from the License Type at creation. Can be overridden at the product or variation level.

Helper text: “Maximum number of active installations (0 = unlimited).”

Special Value: Set to 0 for unlimited activations.

Expiration Date #

When the license expires.

Field Type: Date picker (YYYY-MM-DD format)

Helper text: “Leave empty for lifetime licenses.”

Usage:

• Leave blank for Lifetime licenses
• Set specific date for timed licenses
• For licenses created from a License Type with is_lifetime = true, this field is null and the Expiration column shows “Never”

Status #

Current license state.

Options:

• Active (default)
• Expired
• Suspended
• Cancelled
• Revoked

Note: When creating new licenses, Active is the default.

Fields NOT on Add New Form #

These only appear on Edit License or License Detail view:

• Order ID (automatically set from WooCommerce)
• Purchase Date (automatically set)
• Variation (automatically determined from the order; reflects the specific variation purchased for variable products)
• Domain Restrictions (advanced feature)
• Advanced Options (Version Access, Beta Access, etc.)
• Internal Notes
• Activity Log

Related Topics #

• [Creating a License Manually](#)
• [Editing an Existing License](#)
• [License Status Guide](#)
• [License Types](#) (Part 13)