# Entitlements

Read a live agreement from the HubSpot deal it belongs to, without opening the Fours Console.

---

## Overview

The **Entitlements** tab on the Fours deal card lists the agreements created when a buyer accepted one of your offers. An entitlement is the live contract: the offer is what you sent, the entitlement is what the buyer is actually running on.

## What the card shows

Selecting an entitlement opens its info panel. Which rows appear depends on the marketplace and the contract — a field with nothing behind it is omitted rather than shown empty.

| Field | What it is |
| ----- | ---------- |
| **ID** / **External ID** | Fours' identifier, and the marketplace's own. |
| **Status** | Where the agreement stands. |
| **Type** | The entitlement type. |
| **Offer Delivery Method** | How the offer reached the buyer. |
| **Partner** | The marketplace it came from. |
| **Start Time** / **End Time** | The contract window. On a GCP entitlement both show a Pacific date and time, with PST or PDT, as GCP's Producer Portal does. |
| **Creation Time** / **Last Update Time** | When Fours created and last synced the record. |
| **Term Length** | The contract term. |
| **Currency** | The contract currency. |
| **Commit Amount** | The committed amount. |
| **Gross Amount** | The gross contract amount. |
| **Invoiced Amount** | What has been invoiced so far. |
| **Billing Cycle** | How often the buyer is billed. |
| **Auto Renew** | **Yes** while the agreement is set to renew automatically. When auto-renewal is off, the row is left out. |
| **Renewal Disabled Reason** | Why the agreement will not renew, when it will not. |
| **Initial Agreement ID** | The first agreement in a renewal chain. |
| **Seller Notes** | Notes carried on the agreement. |

Fours also keeps an active GCP entitlement's **End Time** aligned with the end of its offer's term, so an End Time that was recorded a day late is corrected on a later sync. See [GCP: dates in Pacific time](/hubspot-app/hubspot-app-offer/#gcp-dates-in-pacific-time).

## Downloads

Two buttons appear at the bottom of the panel when there is something to fetch:

| Button | What it gives you |
| ------ | ----------------- |
| **EULA** | The end-user licence agreement for the entitlement. |
| **Invoice** | The invoice for the entitlement. |

Both open in a new tab.

## AWS renewal details

An AWS agreement carrying [pre-authorized auto-renewal](/aws-marketplace/pre-authorized-auto-renewal/) terms grows a **Renewal** section, read-only, with the terms the buyer accepted:

| Field | What it tells you |
| ----- | ----------------- |
| **Renewal status** | Whether the agreement is set to renew. |
| **Renewal Pricing** | The uplift shape that was agreed. |
| **Price uplift range** | The pre-negotiated minimum and maximum, on a range term. |
| **Default uplift percentage** | Where inside the range the uplift sits if nobody adjusts it. |
| **Uplift status** | Whether the uplift is still open or locked in: *Pending uplift*, *Finalized YYYY-MM-DD*, or *Finalized*. See [Adjust the renewal uplift](#adjust-the-renewal-uplift). |
| **Renewal count** | How many renewals are authorized. |
| **Lockout date** | The date after which opting out is no longer possible — the renewal decision deadline set on the offer. |
| **Adjustment deadline** | The date after which the uplift can no longer be changed. |
| **Next renewal date** | When the next term begins. |
| **Renewal error** | Shown only when a renewal operation failed, with the message. |

When the offer carried one, a **Renewal payment schedule** follows: the contract duration, the number of installments, and the schedule itself.

**Renewal history** shows the chain of agreements this one belongs to, naming the previous agreement. If Fours has not yet read a predecessor, it says **Predecessor pending** rather than showing a broken chain — the current agreement always renders even when the chain lookup is unavailable.

### Adjust the renewal uplift

On a range term, you choose from the card where inside the pre-negotiated range the next renewal's uplift lands. **Adjust Renewal Uplift** appears in the entitlement's actions menu when all of these hold:

- the entitlement is an **ACTIVE** AWS agreement whose renewal term has a price uplift range;
- auto-renewal is still on;
- there is no pending or scheduled cancellation;
- the **adjustment deadline** has not passed;
- the uplift has not been finalized yet.

The **Adjust Renewal Uplift** dialog opens with the agreed **Uplift range**, the **Default uplift** and the **Adjustment deadline**. What you set depends on whether the offer has a payment schedule:

| Offer | What you set |
| --- | --- |
| **Without a payment schedule** | One **Target uplift percentage** for every dimension, previewed line by line under **Contract dimensions** and **Usage dimensions**. Or turn on **Set an uplift per dimension** to give each line its own **Uplift %** — each starts at the range default. |
| **With a payment schedule** | The **Target uplift percentage** applies to the installments, previewed under **Payment schedule preview**. Usage dimensions get their own **Usage uplift percentage**, or per-line values with **Set an uplift per dimension**. Contract dimensions cannot be set one by one, because the schedule prices the committed term. |

When a single uplift applies, the dialog also totals the **Current TCV** and the **Renewal TCV** at that **Price uplift**. Every value has to sit inside the range: **Save as draft** and **Publish** stay disabled until it does, and an out-of-range percentage field shows *"Uplift must be between {min}% and {max}%."* The prices are a preview — Fours recalculates them when you submit, and AWS validates them. Rates show up to eight decimal places, with trailing zeros dropped — *1.05*, not *1.05000000*. If AWS has not generated the renewal offer yet, the schedule preview says so; you can still save or publish the uplift.

Then choose how to submit it:

- **Save as draft** stores the repriced renewal offer as a draft. The buyer is not notified, and reopening the dialog picks the draft up where you left it.
- **Publish** asks you to confirm first: *"Publishing releases this renewal offer to the buyer and notifies them immediately. This action is irreversible."* Click **Confirm publish** to go ahead, or **Keep editing** to go back.

Publishing finalizes the uplift. Once the publish goes through, **Adjust Renewal Uplift** disappears and **Uplift status** reads *Finalized* with the date. Opting out is separate and stays available until the lockout date.

| Uplift status | What it means |
| --- | --- |
| *Pending uplift* | A range uplift that has not been finalized. You can still adjust it before the adjustment deadline — saving a draft leaves it here. |
| *Finalized YYYY-MM-DD* | Locked in on that date: you published it, or AWS finalized it when the adjustment window closed. |
| *Finalized* | A fixed-percentage or no-uplift term. There is nothing to adjust. |

```d2
direction: right
pending: "Uplift status:\nPending uplift"
dialog: "Adjust Renewal Uplift"
final: "Uplift status:\nFinalized YYYY-MM-DD"
pending -> dialog: "before the\nadjustment deadline"
dialog -> pending: "Save as draft\n(buyer not notified)" {style.stroke-dash: 4}
dialog -> final: "Publish, then Confirm publish\n(irreversible)"
pending -> final: "deadline passes:\nAWS finalizes"
```

### Opt out of auto-renewal

The entitlement's actions menu offers **Opt Out of Auto-Renewal**, which stops the agreement renewing. It is available only **before the lockout date**, whether or not the uplift has been finalized.

:::warning
Opting out is not reversible from Fours. Restoring the renewal means a new offer.
:::

Once the renewal is off — because you opted out, or the agreement is otherwise set to expire — **Renewal status** reads *Auto-renew off*, **Next renewal date** reads N/A, and the **Auto Renew** row is no longer shown.

### Changes take a few minutes

AWS propagates renewal changes asynchronously, so the card does not update the moment you confirm. Refresh the deal after a few minutes to see the state AWS has recorded.

## Related

- [Private Offers](/hubspot-app/hubspot-app-offer/)
- [AWS Pre-Authorized Auto-Renewal](/aws-marketplace/pre-authorized-auto-renewal/)
- [Configuration](/hubspot-app/hubspot-app-configuration/)