# Manage Disposition Codes
Take the PXA course
A *Disposition Code* is a custom code that either initializes an action's state or updates an action's state when it's been updated.
In most cases, disposition codes are used to define custom reasons for why an action has changed (i.e., modified, approved, or reversed). In scenarios with open-ended locking or long action approval windows, disposition codes can provide more transparency to partners, enabling them to see a reporting status update of a pending action.
Disposition Codes are used when submitting conversions to impact.com, or when submitting action updates (modifications & reversals).
#### **Create a disposition code**
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. In the *Program* column on the right, find the *Tracking* section and select **Event Types**.
3. Find the event type you want to add disposition codes to, select  **\[Menu] → Disposition Codes**.
4. On the *Disposition Codes* page, in the top right corner, select **Add Disposition Code**.
5. Configure the disposition code to your requirements:
* **Disposition Code:** Choose whether to use a standard code or create your own code. Disposition codes are case-sensitive—when using them, you must submit the exact value you provide here.
* **Disposition Name:** Provide a name for this disposition code, which will appear on the Disposition Codes page for the event type.
* **State Transition:** Choose the reporting state that this disposition will apply to the action—the partner will be able to see this.
* **Action change:** Choose what will happen to the action when this disposition code is applied.
6. Select **Save** to create the code.
#### **Delete a disposition code**
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. In the *Program* column on the right, find the *Tracking* section and select **Event Types**.
3. Find the event type you want to add disposition codes to, select  **\[Menu] → Disposition Codes**.
4. On the *Disposition Codes* page, find the disposition code you want to delete.
5. In the *Actions* column, select  **\[Drop-down menu] → Delete**.
6. In the warning modal, select **I understand, continue**.
#### **Edit a disposition code**
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. In the *Program* column (right side), find the *Tracking* section and select **Event Types**.
3. Find the event type you want to add disposition codes to, select  **\[Menu] → Disposition Codes**.
4. On the *Disposition Codes* page, find the disposition code you want to edit.
5. In the *Actions* column, select  **\[Drop-down menu] → Edit**.
6. Make your edits, then select **Save**.
Example configuration
In this example, we’ll configure a disposition code for a standard online sale/CPA event type that expects modifications & reversals via a CSV file.
We have three requirements:
* We want a custom disposition code that signifies when an action has been modified due to an item return.
* When we modify an action using this code, we want the partner to be notified that it was because an item in the order was returned.
* The action state will reflect as "modified" in impact.com.
**Creating the disposition code**
1. From the top navigation bar, select  **\[User profile] → Settings**.
2. In the *Program* column (right side), find the *Tracking* section and select **Event Types**.
3. In the list of event types, we need to find the event type we want to modify. In this example, we’ll be modifying our only *Sale* event type.
4. Under the Actions column, select  **\[Drop-down menu] → Disposition Codes**.
5. On the *Disposition Codes* page, in the top right corner select **Add Disposition Code**.
6. From here, we configure the disposition code to our requirements.
7. Select **Save**. Now this disposition code can be used as the `Reason` when modifying actions (either [via a CSV file](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-overview) or [via the API](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview), depending on our event type configuration).
---
# 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://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md?ask=
```
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.