> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msportal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Review agreements before they renew

> Work the contract review queue: assign reviews, email the client from a template, and raise missing Standards.

> [!NOTE]
>
> Branch preview: this feature and its screenshots show an upcoming update.
> It is turned on per MSP, so it may not be in your live portal yet.

**Contract review** is a tab on **Agreements** (or **Contracts**) for MSP staff. It queues each agreement shortly before it ends, or before its yearly anniversary when it has no end date, so someone reviews it, tells the client about any price change, and renews or replaces it in time.

This guide is for MSP staff. Company users never see the tab.

## Before you start

* MSPortal turns **Contract review** on for your MSP. Until then the tab does not appear.
* You need **read agreements** and the **Agreements: Contract review** permission. **Read** opens the queue. **Manage** also lets you assign and update reviews, email clients, and change the settings. No role has the permission at first, so a Primary Admin grants it in **Settings > Users & Roles**. See [Users and roles](https://docs.msportal.ai/user-guides/settings/users-roles.md).
* Agreements come from your PSA. Contract review reads them and never changes the PSA.

## Set up the queue

Nothing is queued until someone with **Manage** saves the settings once.

**1. Open Review settings**

Click **Agreements**, then the **Review settings** tab.

**2. Set the Lead window (days)**

An agreement enters the queue this many days before its end date. An agreement with no end date enters the same number of days before each anniversary of its start date. The default is 90. Use 1 to 365.

**3. Pick the Contract reviewer**

This person is told about every agreement that enters the queue. Only people with **Manage** on Contract review are listed, because the reviewer assigns reviews. You can leave it empty.

**4. Click Save**

Agreements already inside the window are queued straight away, and the message tells you how many.

![Review settings tab showing the Lead window field set to 90 days and the Contract reviewer picker](https://mintcdn.com/msportal/3v1W4OU6oAHmwQ_7/images/product/agreements-contract-review-settings.png?fit=max\&auto=format\&n=3v1W4OU6oAHmwQ_7\&q=85\&s=4676e02d1f362dd8d77c811ce9aa156f)

Branch preview: the Review settings tab, with sample data.

Reviews already in the queue stay there if you make the window shorter.

## Which agreements are queued

MSPortal checks once a day. An agreement is queued when it is active in the PSA (its status is **Active** and it is not cancelled) and one of these is true:

| Review | When it is queued |
| - | - |
| **Renewal** | The agreement has an end date that falls inside the lead window. |
| **Annual review** | The agreement has no end date, and the next anniversary of its start date falls inside the lead window. |

An agreement the PSA marks as open-ended counts as having no end date, even when it still carries an old end date.

Each agreement has one open review at a time. When you close a review, it moves to **Closed** and stays there as history. Next year's review is a new one.

## Who is notified

When agreements enter the queue, MSPortal sends one email and one in-app notification to:

* the company's **account manager**: whoever holds the role mapped to your PSA's account manager, or a role named **Account Manager**, on the company's **Team** tab, and
* the **Contract reviewer** from Review settings.

Only people with the **Manage** permission for Contract review are notified, because the notice asks them to assign the review. An account manager with read access only sees the queue but gets no notice. Someone with several agreements gets one message listing them all. A review that someone assigns before the daily check is still announced. Agreements of the demo company are queued but never announced.

MSPortal never emails a client contact by itself. Only a person sends the client email, from a review.

## Work a review

**1. Open the Contract review tab**

**Open** lists every review that is not done or skipped, soonest due first. **Closed** lists the history. The list follows the company selector. A review past its **Due** date is marked **Overdue**.

**2. Click a row**

A panel shows the agreement's dates, billing and PSA status. **Open agreement** takes you to the agreement itself.

**3. Assign it**

Pick an **Assignee**. Only people with **Manage** on Contract review are listed. A review that was **Due** becomes **Assigned**, and the assignee gets an in-app notification.

**4. Update Status, Due date and Notes**

**Status** and **Due date** save when you change them. Type your **Notes** and click **Save notes**. Notes are for your team only.

**5. Close it**

Set **Status** to **Done** or **Skipped**. You can reopen a closed review by choosing another status, unless a newer review is already open for the same agreement.

![Contract review tab listing six open reviews with their review date, due date, status and assignee](https://mintcdn.com/msportal/3v1W4OU6oAHmwQ_7/images/product/agreements-contract-review-queue.png?fit=max\&auto=format\&n=3v1W4OU6oAHmwQ_7\&q=85\&s=b9da4e39a52d8e4b08874c96fc684002)

Branch preview: the Contract review queue, with sample data.

![Review panel for a Managed Services agreement showing status, due date, assignee, notes and two standards to raise](https://mintcdn.com/msportal/3v1W4OU6oAHmwQ_7/images/product/agreements-contract-review-sheet.png?fit=max\&auto=format\&n=3v1W4OU6oAHmwQ_7\&q=85\&s=62b00d44a96dfd51ffeb68e2b5ac1324)

Branch preview: one review, with the Standards to raise.

| Status | Meaning |
| - | - |
| **Due** | In the queue, nobody assigned. |
| **Assigned** | Someone owns it. Assign a person to reach it; setting an assigned review back to **Due** removes the assignee. |
| **In review** | Work has started. |
| **Client contacted** | The client has been told. Set automatically when you send the email. |
| **Done** | Finished. |
| **Skipped** | Closed without a review. |

If someone else changes a review while you have it open, your change is not saved. The panel reloads with theirs so you can make yours again.

## Email the client

**1. Click Email client in the review**

A dialog opens. Nothing is sent until you click **Send**.

**2. Choose a Template**

The list holds your templates of the **Contract Review** type and the built-in **Default Contract Review**. Create your own in **Settings > Email**. See [Email templates](https://docs.msportal.ai/user-guides/settings/email.md).

**3. Choose Send from**

Pick one of your sender addresses. If your MSP has none, the email goes from the address your email settings resolve to.

**4. Choose the contacts under To**

The list holds the company's contacts that have an email address. Each contact gets their own email, so the greeting uses their name. The emails go out together: all of them, or none if the send fails.

**5. Untick any Standards you do not want to mention**

See [Raise missing Standards](#raise-missing-standards).

**6. Read the Preview, then click Send**

The preview is the email exactly as the first contact receives it. **Send** stays off until the preview shows your current choices.

![Email dialog with a template, a sender address, two contacts, two standards ticked and the merged email preview](https://mintcdn.com/msportal/3v1W4OU6oAHmwQ_7/images/product/agreements-contract-review-compose.png?fit=max\&auto=format\&n=3v1W4OU6oAHmwQ_7\&q=85\&s=4b4ba37feab7febcb52dee9cfc6d38c0)

Branch preview: the email, merged and ready to send.

After the send, the review moves to **Client contacted** and the email appears under **Client emails** with who sent it, when, to whom, from which address, and which Standards it listed.

A **Contract Review** template can use these variables:

| Variable | Filled with |
| - | - |
| `{{recipient_greeting}}` | A greeting with the contact's first name, such as "Hi Alex,". |
| `{{recipient_name}}`, `{{recipient_firstname}}` | The contact's name. |
| `{{company_name}}` | The client company. |
| `{{agreement_name}}` | The agreement. |
| `{{agreement_start_date}}`, `{{agreement_end_date}}` | The agreement's dates. The end date is empty for an open-ended agreement. |
| `{{review_date}}` | The end date, or the anniversary under review. |
| `{{qualifying_standards}}` | A line and a list of the missing Standards you left ticked. Empty when there are none. |
| `{{sender_name}}`, `{{sender_company}}` | You and your MSP. |
| `{{today}}`, `{{portal_name}}`, `{{company_logo_url}}` | The date, your portal name and your logo. |

## Raise missing Standards

Mark the Standards worth raising with a price change, such as a password manager. A review then lists the ones its company is missing.

**1. Open Settings > Standards**

You need **Manage** on Standards settings.

**2. Open a standard and turn on Raise at contract review**

The switch saves on its own.

![A standard's details in Settings > Standards with the Raise at contract review switch turned on](https://mintcdn.com/msportal/3v1W4OU6oAHmwQ_7/images/product/standards-raise-at-contract-review.png?fit=max\&auto=format\&n=3v1W4OU6oAHmwQ_7\&q=85\&s=0d4b185858db680f5ec904e8ab4b15f3)

Branch preview: the switch in a standard's details.

In a review, **Standards to raise** lists every marked standard that applies to the company and is neither deployed nor already billed. This is the same gap the Standards **White space** view shows as open. The list needs **read Standards** access and Standards white space turned on for your MSP. Without them, the review says the list is not available.

## Troubleshooting

| Problem | What to check |
| - | - |
| No **Contract review** tab | MSPortal has not turned it on for your MSP, or your role lacks **read agreements** or the **Agreements: Contract review** permission. |
| The queue says it is not set up | Save **Review settings** once. |
| An agreement is missing from the queue | It must be active in the PSA, and its end date or anniversary must be inside the lead window. The queue updates once a day and when settings are saved. An agreement with an open review does not get a second one. |
| An account manager was not notified | They need the **Manage** permission for Contract review, and the account manager role on the company's **Team** tab. Reviews queued before they had both are not announced later; they are in the queue. |
| A person is missing from **Assignee** or **Contract reviewer** | Only active staff with **Manage** on Contract review are listed. |
| **Standards to raise** is empty | No standard is marked, or the company has them all. A standard outside the company's plan or applicability rules is not listed. |
| No contacts under **To** | The company has no contacts with an email address. |

## Frequently asked questions

> [accordion] Does this change the agreement in my PSA?
>
> No. Renew, replace or reprice the agreement in the PSA. Contract review tracks the review and the email.

> [accordion] Will a client ever get an email automatically?
>
> No. The daily notice goes to your own staff. A client email is sent only when a person clicks Send in a review.

> [accordion] Can company users see reviews or notes?
>
> No. The tab, the reviews and the notes are for MSP staff.

> [accordion] What happens to a review when the agreement is removed from the PSA?
>
> It leaves the queue with the agreement.

## Related guides

* [Agreements overview](https://docs.msportal.ai/user-guides/agreements/index.md)
* [Find and review an agreement](https://docs.msportal.ai/user-guides/agreements/view-agreements.md)
* [Standards settings](https://docs.msportal.ai/user-guides/settings/standards.md)
* [Email settings](https://docs.msportal.ai/user-guides/settings/email.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.