> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/equipme/my-company/employees/how-to-configure-the-swap-addon.md).

# How to configure the swap addon

With the Swap Add-On, you can offer your customers the ability to request a replacement for a device or component when it's, for example, defective, lost, or outdated. Here’s how you can set up the Swap Add-On in your service portfolio:

![](https://media1-production-mightynetworks.imgix.net/asset/46b186a0-bb34-45af-b6f3-ab2f3aed6fc4/1729132744034.png?ixlib=rails-4.2.0\&fm=jpg\&q=75\&auto=format\&w=1400\&h=1400\&fit=max\&impolicy=ResizeCrop\&constraint=downsize\&aspect=fit)

* Navigate to **Service Portfolio** in Equipme and select the option to add a new Add-On service.
* Click on "Add" to create a new Add-On. A new window will open where you can choose the Add-On type.
* In this window, choose the Add-On type **"Swap"**. This will configure the Add-On to be used as a swap service for existing devices or components.

![](https://media1-production-mightynetworks.imgix.net/asset/8a0973df-6061-4e11-9d22-8459b3ee85d7/1729131244895.png?ixlib=rails-4.2.0\&fm=jpg\&q=75\&auto=format\&w=1400\&h=1400\&fit=max\&impolicy=ResizeCrop\&constraint=downsize\&aspect=fit)

<figure><img src="/files/lcbEkEiLCJZIxNDBTum2" alt=""><figcaption></figcaption></figure>

**Define Swap Options**\
&#x20;Configure Service Options: Define any options you want the requesting user to select for the Swap Add-On. This could include the selection of a reason, urgency, or any other options you'd like to offer them. For example:

* **Defective**: The device is no longer functioning properly.
* **Lost**: The device has been lost.
* **Outdated**: The device is outdated or no longer meets the requirements.
* **Other**: For any other reasons that don’t fit into the standard options.

By configuring these service options, you ensure that you gather all necessary information before the replacement process begins. This helps you understand the reason for the replacement and act accordingly.

**Activate**: Once you’ve configured the Swap Add-On, activate it for the relevant services. Your customers will now be able to use the Swap feature directly within the Servicedetails.

> It is important to note that the Swap add-on only works for **active services**. This guarantees that you can only initiate the swap process for services currently in use, keeping your operations structured and organized.


---

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

```
GET https://hub.equipme.io/equipme/my-company/employees/how-to-configure-the-swap-addon.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.