> For the complete documentation index, see [llms.txt](https://docs.nalpeiron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nalpeiron.com/zentitle2-docs/ui-entitlements/maintenance-options.md).
# Maintenance options
Add a maintenance option to an offering or entitlement to control whether a customer is entitled to free upgrades or an active support package.
Each **Offering** and **Entitlement** (inherited from the offering) can contain a maintenance option.
This can control whether users can update the application to a new version. For example, a user can buy a perpetual entitlement for v1 with maintenance for a year, and if v2 is released within a year, the user is entitled to this upgrade because they have the maintenance option enabled.
This feature can also be used to identify if the entitlement owner has a support package.
Maintenance is usually added to an entitlement by default when[ creating an offering](/zentitle2-docs/ui-product-catalog/offerings/managing-offerings.md), where the offering has your maintenance options added as required.
Therefore, when you add entitlements to an offering, it will inherit the maintenance options preset.
### Editing an entitlement to add maintenance
If you choose not to add maintenance to the offering, you can still edit an entitlement and add this option after it is created.
 Select the entitlement you wish to edit from the list.
 Click the edit button on the "details" screen in the top tabs.
 Navigate halfway down the page to the maintenance drop-down box. If you wish to enable the option, then choose that.
If the plan type is anything but perpetual in the offering associated with the entitlement, that will be the only option.
Simply save the change; now this specific entitlement has the maintenance option attached.
If the offering had a perpetual plan, then an expiry date associated with the maintenance can also be edited.
### Entitlement Status
The **Maintenance Expiry Date** field displays the expiration date of the maintenance service associated with the entitlement. This date helps to track when maintenance coverage will end.
* The **Maintenance Expiry Date** is **informational only** and does not affect the actual maintenance status of the entitlement.
* Maintenance on an entitlement can be enabled or disabled independently of its expiry date.
Once the **Maintenance Expiry Date** is set, it will be displayed in the status section of the entitlement, allowing users to view the expiration date directly from the entitlement’s details.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.nalpeiron.com/zentitle2-docs/ui-entitlements/maintenance-options.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
