> 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/scheduled-license-updates.md).

# Scheduled License Updates

{% hint style="warning" %}
Scheduled Updates is available on the **Enterprise plan** only. Contact our [sales team](https://licensespring.com/contact) to get access.
{% endhint %}

Scheduled License Updates allow you to queue future changes to license entitlements ahead of time, with changes applied automatically at the date and time you specify.

{% hint style="info" %}
All scheduled update times are in **UTC** and are hour-precise. Minutes are not supported, changes apply at the start of the chosen hour.
{% endhint %}

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FNAyWzHnzeTV0ERW6Tw9h%2Fimage.png?alt=media&amp;token=70f32cd1-a5a5-495b-9e6b-12285a645655" alt=""><figcaption></figcaption></figure>

### Overview

Instead of applying license changes immediately, you can schedule them for a future date and time. This is useful for:

* Aligning license changes with renewal or billing periods
* Maintaining a full audit trail of scheduled, applied, and cancelled changes
* Viewing upcoming changes across all licenses in one place for reporting

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FAwiH9uQlKRg1oCoZTLWC%2Fimage.png?alt=media&amp;token=3a662578-db91-4eee-97dc-cb756533882e" alt=""><figcaption></figcaption></figure>

### What You Can Schedule

Scheduled updates support the following changes to a license:

* **License fields:** validity period, enabled status, max activations, and other license-level fields
* **Product features:** add, edit, or remove feature flags on a license
* **Custom fields:** update or remove custom field values on a license
* **License reset:** reset one or more license scopes (validity, consumptions, maintenance period, features, custom fields, or metadata) to their default state

### Event Statuses

Each scheduled update has one of the following statuses:

| Status        | Description                                                                                      |
| ------------- | ------------------------------------------------------------------------------------------------ |
| **Pending**   | Scheduled and not yet applied. Can be edited, simulated, or cancelled.                           |
| **Applied**   | Successfully executed. Immutable, no further changes possible.                                   |
| **Cancelled** | Aborted before applying. Immutable, no further changes possible.                                 |
| **Failed**    | The update ran but encountered an error. All changes were rolled back. Can be retried or edited. |

{% hint style="warning" %}
All changes within a single scheduled event apply together. If one change fails, none of the changes in that event are applied and everything is rolled back.
{% endhint %}

### Scheduling a License Update

Navigate to a license and open the **Scheduled updates** tab, then click **+ Schedule update**.

The scheduling drawer has three tabs for staging your changes:

#### License Tab

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2Fq2QYNabHqGkve0XpJj5G%2FScreenshot_2026-09-01_at_2_07_29_PM.png?alt=media&amp;token=c6e35fa8-1886-4a97-8d70-d83029eead16" alt=""><figcaption></figcaption></figure>

Stage changes to license-level fields. The fields available depend on the license type:

* **Options** and **Usage** available for all license types
* **Validity**  available for time-limited licenses only
* **Subscription**  available for subscription licenses only
* **Consumption** available for consumption licenses only

Each change is listed in the **Changes** rail on the right, showing the current value and the new value it will be set to.

#### Features Tab

Add, edit, or remove product features on the license. Features already on the license are labelled **On license**. You can also add features from a group using the **Add features from a group** picker.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FRjALvodt9ldJpsSVGVqn%2FScreenshot_2026-09-01_at_2_08_00_PM.png?alt=media&amp;token=ea32d2b3-4318-47f6-aa3e-f71be2346e67" alt=""><figcaption></figcaption></figure>

#### Custom Fields Tab

Update or remove custom field values. The table shows the product's custom fields with the license's current values.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FnlEkKY1OJnVPG3DKJKJe%2FScreenshot_2026-09-01_at_2_08_08_PM.png?alt=media&amp;token=5b1e6ddf-500e-42fc-b3d3-88ce45d73731" alt=""><figcaption></figcaption></figure>

### Starting from a Policy

If the license's product has license policies configured, a **Start from a policy** option is available at the top of the drawer. Selecting a policy stages only the differences between the policy and the current license, fields that already match are not staged.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2F0PXgrBOtga80zgdiVZCZ%2FScreenshot_2026-09-01_at_2_07_48_PM.png?alt=media&amp;token=d2f236f2-a4df-45ec-937d-ce533d7b0c31" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FR9PuOiiqZj2J43ZvoJq8%2FScreenshot_2026-09-01_at_2_08_26_PM.png?alt=media&amp;token=1a4851b3-540a-410b-9b99-26c61d8492fb" alt=""><figcaption></figcaption></figure>

### Confirming and Submitting

After staging your changes, click **Schedule update**. A confirmation popup displays:

* The license identity (key, product, customer)
* The apply time in UTC
* The number of changes
* The full list of staged changes

{% hint style="info" %}
Only one scheduled update is allowed per license per hour. If an event already exists for the chosen hour, you will be prompted to select a different time.
{% endhint %}

### Scheduling a License Reset

Click **Schedule reset** to open the reset form. Select the scopes to reset:

* **Reset validity period** :  time-limited and subscription licenses only
* **Reset consumptions:** consumption licenses only
* **Reset maintenance period:** only when maintenance is configured
* **Reset product features:** only when the license has features
* **Reset custom fields:** only when the license has custom fields
* **Reset metadata:** always available

{% hint style="danger" %}
Core license data is always reset regardless of scope selection. This action cannot be undone.
{% endhint %}

### Simulate (Dry Run)

Before an event is applied, you can run a **Simulate** to preview what the result would be without making any actual changes. The simulation reports whether the update would succeed or surface any errors.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2Fb3jvsddBGtBlKlNoxKV2%2FScreenshot%202026-09-01%20at%202.30.15%E2%80%AFPM.png?alt=media&amp;token=de391120-6340-4a37-ba1c-a52c8067168c" alt=""><figcaption></figcaption></figure>

Simulate is available on **Pending** events and does not require write permissions.

### Editing a Scheduled Update

Pending and Failed events can be edited from:

* The per-license **Scheduled updates** tab
* The standalone **Scheduled updates** list
* The preview popup

Editing opens the same drawer pre-filled with all staged changes. Saving updates the existing event in place, no new event is created.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FCFqFb8kNC1OvDYMCX4Wd%2FScreenshot%202026-09-01%20at%202.32.59%E2%80%AFPM.png?alt=media&amp;token=c25c8583-e0fa-4a48-a9cd-3f207d0b129c" alt=""><figcaption></figcaption></figure>

For **Failed** events, select a new future hour before saving. Once saved, the event returns to **Pending** status and will be retried at the new time.

### Viewing All Scheduled Updates

Navigate to **Licenses → Scheduled updates** in the sidebar to view all scheduled updates across all licenses in one place.

The list includes:

* **Status summary cards:** counts of Pending, Applied, and Failed events across all dates

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FxaZbbTbXHPbpMg72Fsvu%2FScreenshot_2026-09-01_at_2_06_52_PM.png?alt=media&amp;token=c3c703a9-9635-456d-93e4-402412df09a8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FAp56XlBwJis67f29jng2%2FScreenshot_2026-09-01_at_2_06_58_PM.png?alt=media&amp;token=20f36122-7aa9-4fec-b528-e86cc6280e53" alt=""><figcaption></figcaption></figure>

* **Apply date filter:** defaults to upcoming events; presets include Today, Next 7 days, Next 30 days, Next month, Past, and All time

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2F0AhVxd36HwnHTIQ3bbBc%2FScreenshot_2026-09-01_at_2_07_04_PM.png?alt=media&amp;token=1d1441df-b270-4147-87b6-9c80afed4044" alt=""><figcaption></figcaption></figure>

* **Type filter:** filter by License Update, License Reset, Feature Update, Feature Removal, Custom Field Update, or Custom Field Removal
* **Search:** matches event name, note, license key, customer email, and product name or code
* **Export:** download scheduled update data as a CSV

### Calendar View

Switch to the **Calendar** view to see scheduled updates displayed by day, colored by status. Click an event to open its preview popup, or click **+N more** on a busy day to filter the list to that day.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FFTc3uVpIQlRR56o1zKRX%2FScreenshot%202026-09-01%20at%202.35.20%E2%80%AFPM.png?alt=media&amp;token=fc79ea16-4589-4e3a-888a-35891fbc20c7" alt=""><figcaption></figcaption></figure>

### Permissions

The following actions require `licenses_write` permission:

* Schedule update
* Schedule reset
* Apply now
* Edit
* Cancel
* Retry

**Simulate** and **Export** are read-only actions and do not require write permission.

### Timezone

All times in Scheduled License Updates are in **UTC**, displayed consistently across all views the list, calendar, drawer, confirmation popups, and preview popup.


---

# 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/scheduled-license-updates.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.