For the complete documentation index, see llms.txt. This page is also available as Markdown.

Licenses

Excluded licences are SKUs that CIPP leaves out of its licence counts and reporting. The list is seeded with a set of defaults covering free and trial SKUs that would otherwise inflate reports, and you can add or remove entries to suit your own reporting. Exclusions apply across the whole instance rather than per tenant.

Exclusion Types

An exclusion works in one of two ways, shown in the Exclusion Type column.

Type
Description

Excluded Everywhere

The licence is left out of licence reporting, alerts, and the data sent to integrations such as Gradient. This is the default for a newly added exclusion.

Excluded from Alerts Only

The licence still appears in licence reports and integration data, but is ignored when alerts are evaluated. Use this for SKUs you want visibility of without being notified about them.

Separately from the exclusion type, each entry carries a flag controlling whether the licence still appears in CIPP's licence pickers.

Excluding a licence hides it from reporting, but it does not stop the licence existing in the tenant or prevent it being assigned in Microsoft 365. Allow an excluded licence back into the pickers with Show in License Dropdowns when you still need to assign it from within CIPP.

Page Actions

Button
Description

Adds a licence to the exclusion list.

Re-applies CIPP's default exclusions from its bundled configuration.

Add Excluded License

The dialog offers two ways of identifying the licence.

Field
Description

Advanced Mode

Switches from picking a known licence to entering the details by hand. Leave off unless the licence you want is not in the list.

Select License

The licence to exclude, chosen from CIPP's built-in list of Microsoft 365 SKUs. Where two products share a display name, the GUID is appended so you can tell them apart. Shown when Advanced Mode is off.

GUID

The SKU identifier of the licence, for example f30db892-07e9-47e9-837c-80727f46fd3d. Shown when Advanced Mode is on.

SKU Name

The display name to record against the GUID, for example MICROSOFT FLOW FREE. Shown when Advanced Mode is on.

Microsoft publish the full list of product names, SKU identifiers and service plans in their licensing service plan reference, which is the place to look up a GUID for Advanced Mode.

A licence added this way is set to Excluded Everywhere. Change it afterwards with the Only Exclude from Alerts row action if you want the narrower behaviour.

Restore Defaults

Field
Description

Full Reset (clear all entries including manually added ones)

Clears the entire list before restoring the defaults. Leave this off to add any missing defaults while keeping your own entries and any changes you have made to existing ones.

Table Details

Column
Description

Product Display Name

The name of the excluded licence.

GUID

The SKU identifier of the licence.

Exclusion Type

Whether the licence is excluded everywhere or only from alerts.

Show In License Dropdown

Whether the licence still appears in CIPP's licence pickers despite being excluded.

Table Actions

Action
Description
Bulk Action Available

Only Exclude from Alerts

Narrows the exclusion so the licence is ignored by alerts but still appears in reports and integration data.

Show in License Dropdowns

Makes the licence selectable in CIPP's licence pickers again. Only offered for licences currently hidden from them.

Hide from License Dropdowns

Removes the licence from CIPP's licence pickers. Only offered for licences currently shown in them.

Delete Exclusion

Removes the licence from the exclusion list, so it is counted and reported on again.

More Info

Opens the Extended Info flyout with the full details for the selected row.


Feature Requests/Ideas

We value your feedback and ideas. Please raise any feature requests on GitHub.

Last updated

Was this helpful?