> For the complete documentation index, see [llms.txt](https://docs.adaptiva.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptiva.com/patch/advanced-settings/customized-products.md).

# Customized Products

Customized Products allow you to customize installation commands when a patch is being installed.

Some patches require additional configurations to support licenses, API keys, or other application configuration specifics. When a product update is released, devices assigned to a Deployment Wave or applied Business Unit will install the update using the settings configured in the associated customized product.

An example of this is Duo Authentication. To apply a patch to Duo, you must specify an API hostname, an integration key, and a secret key. There are also a number of optional configurations that you can specify.

You can create multiple instances of a Customized Product for the same product, as long as each instance targets different Business Units. For example, you may have different configurations of the same product for different departments of your business.

For products with optional customizable patch configurations, the Adaptiva metadata team has configured default values wherever possible, but you can view and override these values when you set up a Customized Product.

You can also configure how to handle potential interfering processes that would prevent the patch installation, as well as override maintenance and reboot window settings.

{% hint style="info" %}
Additionally, you can configure custom sensor action scripts to perform device specific commands before and after patch installation, but these are advanced scenarios and you should consult with the [Adaptiva Support Team](https://adaptiva.com/support) before trying to implement any solution.

You can also reach out to the support team for any detailed guidance on using customized products.
{% endhint %}

## Create a Customized Product

1. Select **Advanced Settings > Customized Products** from the left side navigation.

   ![](https://2503798551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7VJNM00p5XQ4pMWqCu8y%2Fuploads%2Fgit-blob-a51dc8127c62ac410140d19f753b36034545af5b%2Fside-navigation.png?alt=media)
2. Select **+ New** in the upper-right to open a new template:

   ![](https://2503798551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7VJNM00p5XQ4pMWqCu8y%2Fuploads%2Fgit-blob-e3f6f3d92a3ea90608efd6594cc3876198270694%2Fnew-button.png?alt=media)

Before you can customize a product, you must first select the target product in the **General Settings** pane on the right side.

### General Settings

1. Enter a **Name** and a detailed **Description**.
2. Click **Browse** to add a [Deployment Wave](https://docs.adaptiva.com/patch/advanced-settings/deployment-waves.md) ***OR*** add one or more [Business Units](https://docs.adaptiva.com/patch/patching-fundamentals/business-units.md).
   * If using OneSite Patch version 10.0.971+, we recommend selecting a Business Unit(s).
3. Click **Browse** under **Target Product** to add a desired product.

   ![](https://2503798551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7VJNM00p5XQ4pMWqCu8y%2Fuploads%2Fgit-blob-fa668f723f168861a222cfc2f182e429e068a072%2Fgeneral-settings.png?alt=media)

### Product Specific Settings

The list of available customizations reflects the settings you can customize in the software product you selected. These include:

* **Install**
* **Repair**
* **Uninstall**
* **Install Time**
* **User Portal**
* **Extensions**
* **Product**

Depending on which product was selected, the customizations within these settings may vary. Below are some examples of individual customizations.

{% hint style="info" %}
We recommend that you ignore the **Edit Configuration** button unless you are directed to interact with it by the [Adaptiva Support Team](https://adaptiva.com/support).
{% endhint %}

![](https://2503798551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7VJNM00p5XQ4pMWqCu8y%2Fuploads%2Fgit-blob-5cfdfb6eee41d598bda225be43a0a871c4d4a706%2Fproduct-settings.png?alt=media)

#### Install Settings

* **Customize Install Directory** - When toggled **ON**, you have the option of entering a **Custom Install Directory** path where you would like the product to be installed.
* **Delete Desktop Shortcut** - This as it says, will delete the Desktop Shortcut when toggled **ON**.
* **Disable Auto Updates** - When toggled **ON**, this will ensure that auto-updates are disabled.

#### Repair and Uninstall

These settings allow you to change the behavior of repairing the product installation, or uninstalling the product.

#### Install Time

* **Suppress Reboots** - When toggled **ON**, this will disable system automated reboots.
* **Interfering Process Handlers** - This setting allows you to select the interfering process from the first dropdown and the desired behavior from the second dropdown. Once you have selected each, you can click **Save** to add it to the list of items.

  * Each interfering process will be prepopulated for you to choose from. Some products may not have any interfering processes, while other products will have several for you to add.

  For each interfering process, you can select one of the following options:

  * **Force stop immediately**
  * **Force stop immediately with popup**
  * **Force stop and restart**
  * **Force stop and restart with popup**

  When a **with popup** option is selected, the device displays a popup indicating that the interfering process will be terminated and gives users an option to terminate immediately. Otherwise, the Adaptiva client will terminate the process after 1 hour.

  When a **restart** option is selected, the Adaptiva client will restart the interfering process after installation is complete.

#### User Portal

The User Portal Properties allow you to add custom metadata to your chosen product. These properties will aid in user portal functionality like search and filter. These properties include:

* **Name** and **Description** - Enter a name and description.
* **Version** - Enter the version of your product.
* **Vendor Name** - Enter the Vendor name of your product. i.e. Adobe.
* **Categories** - Enter custom categories and click **Add** to add to a list of categories.
* **Keywords** - Enter custom keywords and click **Add** to add to a list of keywords.

#### Extensions

{% hint style="info" %}
Extensions are advanced scenarios and you should consult with the [Adaptiva Support Team](https://adaptiva.com/support) before trying to implement any solution.
{% endhint %}

Extensions allow you to add the following action sequences and order each by primary step:

* **Pre-Installation**
* **Post-Installation**
* **Pre-Repair**
* **Post Repair**
* **Pre Uninstallation**
* **Post Uninstallation**

#### Product

By default, Patch clients run a full scan every day at a random time between the hours of 6 am and 2pm and use their inherited maintenance window and reboot schedule. The **Product Properties** allow you to set a custom scan schedule, maintenance window override, and reboot window override.

This is useful when some products can be too resource-intensive to scan daily, or need to run during a different maintenance and reboot window than less resource intensive products.

* **Scan Schedule** - Click **Add Scan Schedule** to add an existing schedule or create a new schedule.
* **Maintenance Window Override** - Click **Browse** to select an existing maintenance window or create a new maintenance window.
* **Reboot Override** - Click **Browse** to select an existing reboot window or create a new reboot window.

### Save

After you have entered all of your desired customizations, click **Save**. This product will now be added to the Customized Products table. Repeat this process for any additional customized products.
