# Configure Return Codes in a Patch My PC Cloud Deployment

*Applies to: Patch My PC Cloud*

The **Return Codes** tool of the Patch My PC (PMPC) Cloud deployment wizard allows you to configure *Return Codes* for a deployment (a *Return Code* is a numerical code an app typically logs and reports once it has completed running its installer).

You can manage Return Codes from within the properties of a:

* Deployment
* Custom App

{% hint style="info" %}
**Note**

See the [Configuration ](https://docs.patchmypc.com/patch-my-pc-cloud/custom-apps/create-a-custom-app/custom-apps-configuration-tab)section of [Create a Custom App](https://docs.patchmypc.com/patch-my-pc-cloud/custom-apps/create-a-custom-app) for details on how to configure Return Codes within the properties of a Custom App.

Also, macOS apps also do not support Return Codes.
{% endhint %}

To manage Return Codes for a Deployment:

1. Click the **Return Codes** tool.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FaYZdg34WS5yQr0EDPdmv%2Fimage.png?alt=media&#x26;token=15b902ed-7f8b-445a-b375-f3c9dca38b51" alt="Clicking the &#x27;Return Codes&#x27; tool" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

The number beside the **Return Codes** tool shows the number of return codes currently configured for the app being deployed.
{% endhint %}

The default Return Codes defined for the app are shown, plus any defined for the app if this is a Custom App.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FsvoNQIulcgzbjaHp0YEK%2Fimage.png?alt=media&#x26;token=9725e744-3561-4c60-80d6-ec3b082c2b96" alt="Default return codes" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

If a vendor supplies a list of Return Codes for their app, we include it. If they don’t, we automatically populate the list of Return Codes with industry-standard codes.
{% endhint %}

3. If you do not want to add a new Return Code, proceed to Step 5.
4. To add a new Return Code for this deployment, enter the numerical value in the **Return Code** field, select its meaning from the **Code type** dropdown, then click **Add**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Ft6Di2vZy7zbt7y8pNXC9%2Fimage.png?alt=media&#x26;token=d3f99ba3-5fbf-46a5-84d3-cb477ea3ca81" alt="Adding a new Return Code" width="436"><figcaption></figcaption></figure>

The new Return Code is added to the list.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FnYL7c9tnP5WsUbUhcvyv%2Fimage.png?alt=media&#x26;token=16312dbc-da9e-4bb2-aa6a-9e9193ae42e6" alt="New Return Code added to the list." width="419"><figcaption></figcaption></figure>

5. If you do not want to edit a Return Code, go to Step 9.
6. To edit a Return Code, click the pencil icon beside it.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FQfU68ch3ahBzHkYHVn5W%2Fimage.png?alt=media&#x26;token=d815660d-7a1a-4c87-845f-f28bd655f668" alt="Clicking the pencil icon beside a Return Code to edit it." width="419"><figcaption></figcaption></figure>

7. Make any required changes.
8. Click the green tick to save your changes.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FTfiD1ItpRQ0rf2KRKnkv%2Fimage.png?alt=media&#x26;token=cb18a477-ea40-41b7-9e39-6f547a7eb4e2" alt="Clicking the green tick to save your changes" width="422"><figcaption></figcaption></figure>

The **Code type** field is updated.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Fk06qSQs2NGVFHdy1ksGS%2Fimage.png?alt=media&#x26;token=7b42f06c-53d3-4939-b165-b0d70d75d719" alt="“Code type” field updated." width="420"><figcaption></figcaption></figure>

9. To delete a Return Code, click the red trash can beside the relevant code.

{% hint style="info" %}
**Note**

You cannot delete either the default Return Codes for a deployment or any that have been added as part of the Custom App’s configuration. However, you can edit them.

If you add a Return Code to a deployment, you will be able to edit or delete it from the deployment if required.
{% endhint %}

{% hint style="danger" %}
**Important**

If the Return Codes you define in a deployment differ/conflict with those defined for a Custom App, the Return Codes defined on the deployment take precedence.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FolnA9X8xpDbGoUzqNmcW%2Fimage.png?alt=media&#x26;token=aa1092b2-65cb-456c-b2bf-b7c523ce6d0c" alt="Deleting a Return Code" width="420"><figcaption></figcaption></figure>

The code is deleted from the list.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FsBZ2gj1z687krfW7eyuR%2Fimage.png?alt=media&#x26;token=141d2855-3974-4903-af30-630eff81a085" alt="Code deleted from the list" width="425"><figcaption></figcaption></figure>

## Next Steps

If you do not want to configure any additional settings, click **Next** to move to the [Assignments](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/deploy-app/assignments-tab) tab.

Otherwise, navigate to the relevant tool to configure the required settings, which are explained in the relevant section.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F4d7ankFXZ6PyF2SmXh3P%2Fimage.png?alt=media&#x26;token=24157b0c-5967-463d-bf55-3c93e80c8345" alt="Clicking &#x27;Next&#x27;" width="563"><figcaption></figcaption></figure>
