> For the complete documentation index, see [llms.txt](https://docs.licensespring.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.licensespring.com/vendor-platform/licenses/issuing-new-licenses.md).

# Issuing New Licenses

There are a few ways you can issue licenses:

* Manually through the Vendor platform
* Through the Management API
* With one of our integrations

## Our Data Model

Before issuing a license, it might help to know how our data model is organized:

![](/files/5558564d81ab19a66799169d95f5e2477a4ccf37)

* **A License** can belong to an order. An order can have zero to many licenses.
* **An Order** can belong to a customer. A customer can have zero to many orders.
* **A Customer** can belong to an account. An account can have zero to many customers.

{% hint style="info" %}
A License will belong to an order. If you do not specify an orderID, a random orderID will be generated.
{% endhint %}

Orders do not need to belong to customers. However, it can be useful to have this association for analytics or customer support.

## Issuing New Licenses Manually Through the Vendor Platform

{% hint style="info" %}
We are assuming you have already created a product within your vendor account.
{% endhint %}

To issue a new license for your product, follow these steps:

{% stepper %}
{% step %}

### Open the Licenses tab and create a new order

Click on the "Licenses" tab on the left, then click "create new order" on the right of the screen.

![](/files/e612020a1b077420ca5ce922ee43eed77ae870c1)
{% endstep %}

{% step %}

### Add order identifiers and (optional) customer information

The next screen allows you to add order identifiers and customer information; these fields are optional. Click Next.

![](/files/17b7ad88288ccb994d61be9f943367ef5d9eb17d)
{% endstep %}

{% step %}

### Configure the licenses to issue

Click "Add Product" and use the configuration screen to set the entitlements for the license.

![](/files/4467cc186e6c6c315d2bdebf6eaabe6dccee1ec0)

Select the product and configure the licenses. You can choose a license policy (if previously created) or select "use custom values" to fully customize the license entitlements.

You can specify options such as:

* License type: Perpetual, Time-limited, Subscription, or Consumption-based
* Which features are included in the license
* Maximum activations (how many devices can node-lock to the license)
* Unique values for license custom fields
* Etc.
  {% endstep %}

{% step %}

### Confirm and create the order

When finished configuring entitlements, click "Confirm". Review the configuration on the "Confirm Order" screen and press "Create order". The Order detail page will appear where you can retrieve your new licenses.

![](/files/865dea504f0419f64c54d6215c2617aa7ef8bd3d)

![](/files/c407749c150bcb0dbc5c76734c2dbad782dac832)

![](/files/31c81f2d31acbaae2491280e9cf06ef0932ef1b7)
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.licensespring.com/vendor-platform/licenses/issuing-new-licenses.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.