Entitled Major Version #

Version note: The Entitled Major Version field was introduced in v2.0.0.

What It Is #

The Entitled Major Version is a version number stamped on a license at the time of purchase. It records which major version of your software the customer paid for.

This field is informational — DDLS stores it and exposes it via the API, but does not enforce version gating itself. Your client software is responsible for reading this field and deciding whether to allow updates.

Where It Comes From #

When a customer purchases a product (or variation) that has an Entitled Major Version configured, that value is stamped on the new license record during order processing. It is set once at purchase time and does not change if you later update the product’s entitled version setting.

Who Controls It #

Store administrators set the Entitled Major Version on the product or variation level:

• Product level: WooCommerce > Products > Edit > Licensing tab > License Settings > Entitled Major Version
• Variation level: WooCommerce > Products > Edit > Variations > expand variation > Entitled Major Version

Variation-level settings override product-level settings (standard DDLS inheritance).

Viewing on a License #

On the license detail screen (DDLS > Licenses > click a license), the Entitled Major Version appears in the license metadata section.

Via the API, the field is included in license responses as entitled_major_version.

Version Gating Enforcement #

DDLS does not enforce version gating. Your client software should:

1. Read the entitled_major_version field from the license validation or activation response
2. Compare it against the version of the update being offered
3. Block or allow the update based on your business rules

Example: A customer with entitled_major_version: "3" should receive v3.x updates but not v4.0 unless they upgrade their license.

Use Case #