Licenses

The Licenses page (/it/licenses) provides a paginated list of software licenses for your organization. It supports filtering via LicenseFilterBar and links to individual license records.

​

Overview

The page uses useLicenses with LicenseFilters and pagination (page size 20). License records display in LicenseTable. A New License button navigates to /it/licenses/new.

​

Who it’s for

No explicit secondary permission gate beyond the outer ITViewGuard (it.view). Creating licenses requires it.licenses.create.

​

Before you start

• You must have the IT module permission (it.view).

​

Steps

​

Viewing a license

The License Details page (/it/licenses/:id) displays the full record for a single software license, including its seat allocation, status, and related assignment data. The page renders ITLicenseDetailPage (lazy-loaded from @/cores/it/pages/licenses/LicenseDetailPage). The :id URL parameter identifies the license record to load. No explicit secondary permission gate beyond the outer ITViewGuard (it.view). Editing requires it.licenses.edit; deleting requires it.licenses.delete. Before you start: navigate from the Licenses list (/it/licenses) or from the License Compliance dashboard.

1. From /it/licenses, click a license row, or navigate directly to /it/licenses/:id.
2. View seat allocation, license type, vendor, expiry date, and assignment information.
3. Navigate to /it/licenses/:id/edit to update the license record.

​

Creating a license

The New License page (/it/licenses/new) provides a form for registering a new software license in the IT module. The page renders ITNewLicensePage (lazy-loaded from @/cores/it/pages/licenses/NewLicensePage). The specific form fields are defined in the NewLicensePage component. No explicit secondary permission gate beyond the outer ITViewGuard (it.view). Creating licenses requires it.licenses.create. Before you start: hold the it.licenses.create permission. Have the software vendor, license type, seat count, and expiry date ready.

1. From the Licenses list, click New License, or navigate to /it/licenses/new.
2. Complete all required fields.
3. Submit the form. On success you are redirected to the new license record.

​

Editing a license

The Edit License screen allows updating an existing software license record and is accessible at /it/licenses/:id/edit. The Edit License page loads the existing license via useLicense. If not found, a “License not found” message is shown. The form is rendered using the shared LicenseForm component pre-populated with the existing data. Fields include: name, software name, license type, status, total seats, optional description, optional software version, optional publisher, optional license key, optional purchase date, optional activation date, and optional expiry date. On save, updateLicense is called with the updated data and the user is redirected to the license detail page. Before you start: the license must exist.

1. From the license detail page, click the edit action to navigate to /it/licenses/:id/edit.
2. Modify the relevant fields in the LicenseForm — name, type, seat count, dates, and other optional attributes.
3. Submit the form. On success, the user is redirected to the license detail page.

LicenseForm — Shared form component used for both creating and editing licenses.
total_seats — Number of licensed seats available for assignment.
license_key — Optional; SME should confirm sensitivity and masking requirements.
expiry_date — Optional date when the license expires.

​

Related

Documentation sources

• src/routes/it.tsx
• src/cores/it/pages/licenses/LicenseListPage.tsx
• src/cores/it/pages/licenses/LicenseDetailPage.tsx
• src/cores/it/pages/licenses/NewLicensePage.tsx
• src/cores/it/pages/licenses/EditLicensePage.tsx
• src/cores/it/hooks/useLicenses.ts