Entitlements

The Entitlements screens let you manage the central records in MIDDAG Account. An entitlement is a unique code that represents "this customer has access to this product or service." Every license, contract, environment, and service in the system traces back to an entitlement.

List view

Open MIDDAG Account > Entitlements to see all entitlements across all organizations.

Columns

Column	What it shows
Code	The unique entitlement code (e.g., PLG-2026040142). Clickable -- opens detail view.
Product	The name of the product or service this entitlement represents
Class	The entitlement class: PLG, ENV, SVC, ORD, AFL, or EDU
Organization	The customer this entitlement belongs to (or "Standalone" for sovereign entitlements)
Status	Active (green), Suspended (yellow), Expired (gray), or Cancelled (red)
Starts	The start date of the entitlement period
Expires	The expiration date (blank if no expiration)
Created	When the entitlement was created, and whether it was auto-created or manual

Filters and search

The filter bar above the table lets you narrow the list:

• Search -- type an entitlement code (e.g., PLG-2026040142) for an instant lookup, or search by product name or organization name
• Class -- filter by PLG, ENV, SVC, ORD, AFL, EDU, or All
• Status -- filter by Active, Suspended, Expired, Cancelled, or All
• Organization -- filter to a specific organization
• Billing Entity -- filter by MIDDAG BR, MIDDAG GLOBAL, or All
• Date range -- filter by creation date or expiration date

You can combine filters. For example: Class = SVC, Status = Active, Organization = Acme Corp shows only active service entitlements for Acme Corp.

Pagination

The table shows 25 rows per page by default. You can change this to 50 or 100 using the dropdown in the footer. The footer also shows total count and page navigation.

Detail view

Click any entitlement code to open the detail view. This is the full picture of one entitlement.

Header

The header shows:

• Entitlement code with a class badge (e.g., PLG) and a status badge (e.g., green "Active")
• Product name
• Action buttons: Edit, Suspend, Reactivate, Cancel, Extend, Renew (available actions depend on current status)

Origin chain

Below the header, a visual breadcrumb shows where this entitlement came from:

Quote QUO-20260401  ->  Order #1042  ->  This Entitlement

Each step in the chain is clickable. If the entitlement was created manually (not from a quote/order pipeline), the origin chain shows "Manual creation by [admin name]."

Summary card

A metadata grid shows key information:

Field	Description
Organization	Customer name (clickable link to Organization detail)
Class	Entitlement class with description
Billing Entity	MIDDAG BR or MIDDAG GLOBAL
Period	Start date to expiration date
Value	Total value with currency
Auto-created	Yes (from order pipeline) or No (manual)
Parent	Parent entitlement code if this is a child (clickable)
Children	Count of child entitlements (clickable to see list)

Lifecycle visual

A horizontal state machine diagram shows the entitlement's journey through its lifecycle states:

@ Created --- @ Active --- o Suspended --- o Expired --- o Cancelled
  2026-04-01   Current

Filled circles represent states the entitlement has been through. The current state is highlighted. Past transitions show their timestamps below. Future possible transitions appear as outlined circles.

Tabs

Below the lifecycle visual, tabs organize the entitlement's downstream resources and history:

Tab	What it shows
Overview	Summary of downstream resources + recent activity
Licenses	Linked licenses with activation status (PLG class)
Environments	Linked managed environments (ENV class)
Services	Linked services and service requests (SVC class)
Contracts	Linked service agreements
Invoices	Financial records linked through the order
Activity Log	Full history of status changes, payments, syncs, and admin actions
Policies	Active policies governing this entitlement with their source level
Related Orders	Orders that created or renewed this entitlement

Which tabs appear depends on the entitlement class. A PLG entitlement shows Licenses; an ENV entitlement shows Environments; an SVC entitlement shows Services. The Overview, Activity Log, Policies, and Related Orders tabs always appear.

Actions

The actions available on an entitlement depend on its current status:

Action	Available when	What it does
Edit	Any status	Update metadata (product name, dates, value, notes)
Suspend	Active	Pause the entitlement. Downstream resources are frozen.
Reactivate	Suspended or Expired	Restore to Active status. Downstream resources resume.
Cancel	Active or Suspended	Permanently revoke the entitlement. Downstream resources are deactivated.
Extend	Active	Push the expiration date forward without creating a new order
Renew	Active or Expired	Create a new Quote pre-populated with renewal terms
Override Policy	Any status	Override a specific policy for this individual entitlement
Win-back	Cancelled	Reactivate a cancelled entitlement with the same code

Suspend and Cancel ask for a confirmation and an optional reason note that is recorded in the activity log.

Creating an entitlement manually

While most entitlements are created automatically from the order pipeline, you can also create one manually. Click + Create from the Entitlements list. The form asks for:

• Organization (optional -- leave blank for a sovereign entitlement)
• Product name
• Class (PLG, ENV, SVC, ORD, AFL, or EDU)
• Start date and expiration date
• Value and currency
• Notes

Manually created entitlements behave identically to auto-created ones. The detail view shows "Manual creation" in the origin chain instead of a quote/order reference.

Expiring entitlements

The Dashboard highlights entitlements expiring within 30 days. You can also filter the Entitlements list by "Expiring soon" to see them here. From any expiring entitlement, click Renew to start the renewal flow (creates a pre-populated Quote for the customer).

A daily background job automatically transitions active entitlements past their expiration date to expired status, and expired entitlements past the cancellation timeout to cancelled.

Related pages

• Dashboard -- expiring entitlements and action items
• Organizations -- the customer that owns the entitlement
• Orders -- how purchases create entitlements
• Entitlements (concept) -- lifecycle states, auto-creation, and sovereignty
• Entitlement Classes -- what each class provisions
• Policies -- rules that govern entitlement behavior