---
title: "Warehouse Insight Private Add-On Catalog"
app: "Warehouse Insight"
section: "Reference"
last_updated: "2026-07-24"
url: "https://insight-works.com/kb/warehouse-insight/warehouse-insight-private-add-on-catalog/"
---

# Warehouse Insight Private Add-On Catalog

Warehouse Insight allows you to list your add-on catalog that you can configure with applications that are accessible to multiple tenants without manual deployment.

To enable this functionality, you need the following:

- An externally accessible host to contain the apps and their configurations.
- An addons.json file representing the listing details.
- The Warehouse Insight Setup configured to show the private catalog.

### 1. Accessible URL

The accessible URL must be in a format so that the root contains the addons.json file (e.g., https://your.domain.com/addoncat/) as it is used as the base URL for all other required files from the JSON file. This URL must be accessible through paths, so that the JSON resolves as: https://your.domain.com/addoncat/addons.json

Additional files resolve as: https://your.domain.com/addoncat/private-app/install-file.app

### 2. JSON file

The addons.json file details each add-on that should be listed as available. Here is an example structure:

```
{
    "addons": [
        {
            "name": " Your Name Private App",
            "description": "Provides a feature.",
            "product_required_version": "2.12",
            "version": "1.0.0.0",
            "folder": "private-app",
            "image": "app-icon.jpg",
            "data_file": "configuration-file.txt",
            "app_code_override": "",
            "extension_file": "install-file.app",
            "extension_guid": "uuid",
            "documentation_url": "help-url",
            "category": "Any"
        }
    ]
}
```

- If the app you want to list is XML only you should leave the extension\_file and extension\_guid blank.
- Using the Export option from the _Warehouse Insight Applications_ page allows you to create a configuration file. To include more configuration (e.g. custom setup tables), you can use [Import Export PowerTool](https://dmsiworks.com/apps/import-export-powertool).
- All configurations must be in a single text file. If there are multiple applications, merge all text files into one. Data from identical tables does not need to be merged into the same heading as the same table can be featured multiple times.
- We recommend that your app names are pre or postfixed with your name or an acronym as apps with the same name as an existing Warehouse Insight Add-on Catalog entry will not be displayed.

### 3. Warehouse Insight setup

Configure the following fields:

- _Private Add-on Catalog URL_: The URL of the add-on catalog to be used when downloading private add-ons.
- _Private Add-on Catalog URL Caption_: The caption/grouping to associate with the private add-ons.
- _Private Add-on Catalog Disclaimer_: The message to display when installing a private add-ons.

Once configured, (1) will be used to generate the listings while (2) will caption the section in the addon catalog. Every install action triggers the defined disclaimer.

 Note: Every install action triggers the disclaimer.
