# How to add new items to your agreement

You can add new items to your agreement using the **Buy more** option on the agreement details page. 

Items can only be added to agreements in the active state. If the agreement is not active, the **Buy more** option is unavailable. 

When you select **Buy more**, the platform automatically detects the agreement and takes you directly to the **Items** step of the purchase wizard, where you can choose the items to order and place an order.

### Adding new items to your agreement <a href="#adding-new-items-to-your-agreement" id="adding-new-items-to-your-agreement"></a>

To add new items to your existing Marketplace agreement:

1. Go to **Marketplace** > **Agreements**.&#x20;
2. Select the desired agreement. Make sure that the agreement is active.
3. On the **agreement details** page, select **Buy more** to start the purchase wizard. &#x20;

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/rj1UyYZWV9rkSqyFMO8W/AgeementsDetails.png" alt=""><figcaption><p>Select Buy more to start the ordering process.</p></figcaption></figure></div>

4. Under **Items**, do the following:
   1. Select **Add items**. A new window (also called **Select items**) opens, displaying the products you can order under this agreement.
   2. Select the items you want to order. You can use filters to find the items easily. When selecting items, be sure to verify the billing terms and the duration.
   3. Select **Add items**. Your selected items are added to the agreement, and the **Select items** step is displayed again.
   4. Set the quantity of your newly added items in the **New qty** field. Then, select **Next**.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/Z5DNbniz33mXCZoO62Rm/blobs/Ud7UXNJhKhlwZMSs3fGJ/image.png" alt=""><figcaption><p>The Select Items window displaying individual items you can order.</p></figcaption></figure></div>

5. Under **Details**, add or update the reference ID and your comments. Then, select **Next**.
6. Under **Review order**, verify the information, then select **Place order***.* A change order is created for the agreement and sent to the vendor for fulfillment.&#x20;
7. Select **View details** to open the order details page or select **Close**.

When your order has been placed, the agreement's status changes from **Active** to **Updating**. It means the agreement is temporarily locked, and you cannot place more orders under this agreement until the current change order is completed. To check the status of your order, use the **Orders** page or the **Orders** tab on the **agreement details** page.


---

# Agent Instructions: 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:

```
GET https://docs.platform.softwareone.com/marketplace-platform/getting-started/marketplace-for-clients/add-items-to-an-agreement.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.