Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a definition for your store application

Create a definition for your store app to define the licensing metrics you want collected.

Before you begin

Role required: admin or developer

About this task

Create a definition for an application in development or for an application you have already published. However, if you assign a definition to a published application, you will have to re-publish it with the new definition. Additionally, you can only assign one definition to an application.

Note: You can only create a definition for capacity subscriptions. See Types of subscriptions in Subscription Management.

Procedure

  1. Navigate to All > System Applications > My Company Applications.

  2. Select the application.

  3. Under the Subscription Management section, set Subscription Model to Capacity.

  4. Select the search icon next to License Definition.

    The Application License Definitions pop-up loads.

  5. Select New.

  6. Fill in the Application License Definition record.

FieldDescription
NameName of the definition.
DescriptionBrief summary of the definition.
Metric TypeType of collected metric.
FrequencyHow often metrics are collected.
Performance ValidatedCheck the box if you have tested the performance of the definition.
TableTable used to determine usage.Note: Only lists tables associated with the current application.
QueryCriteria to use on the table.
AggregationType of aggregation. - Set to Count to count all records. - Set to Count \(Distinct\) to count unique records only.
Aggregation ColumnTable column used for aggregation.Note: Column must be indexed to be aggregated.
Group ByColumns in the table to group the data by. Max of 3. Warning: Case sensitive.
  1. Select Submit.

    Your new definition appears in the Application License Definitions pop-up.

  2. Select the definition to apply it to the application.

What to do next

Create a new version of the application and publish it to the ServiceNow Store. While your application is in review, any changes to the definition may cause subsequent versions of your application to be rejected. Once the application is approved and published to the ServiceNow Store, the definition becomes read-only.

To change the definition of an application already on the ServiceNow Store, you must create a new definition, submit a new version of the application, and go through the review process.

Parent Topic:Custom licensing for ISV applications